incubator-pegasus icon indicating copy to clipboard operation
incubator-pegasus copied to clipboard

Improve Pegasus website

Open acelyc111 opened this issue 1 year ago • 1 comments

Background

The Pegasus website (https://pegasus.apache.org) is not well maintenanced for a period of time, some of the documents are out of date, some new features are not mentioned or described how to use, lack a lot of English documents, some links are broken, some pages are not well rendered, etc. Pegasus is an excellent distributed key-value store, it's a basic work to improve and perfect the website to make more users know how it works and how to use it.

NOTE: The codebase of the website is https://github.com/apache/incubator-pegasus-website, which is separated from https://github.com/apache/incubator-pegasus.

Who can countribute?

Anybody! Any volunteer is recruited and encouraged to improve any big or small imprvoments of the website! Don't hesitate to assign the following task to yourself.

How to countribute?

The website is a static website based on Jekyll, and almost all of the documents are wrote in Markdown.

  • Documents: It's a bit of easy to improve the documents as long as you know Markdown.
  • Website: If you are familiar to static website frontend(basic HTML, CSS, JavaScript), you can help to improve the website layout, rendering, multiple version management, etc.

Now you can start with:

  1. Fork the website Github repository
image
  1. Git clone the code of the repository you just forked.
git clone [email protected]:<you_github_id>/incubator-pegasus-website.git
  1. Find a task in the following list, or create a new task if you want.

  2. Write the code to complete the task in your local workspace.

  3. Check if it works as expect:

Install Jekyll at first https://jekyllrb.com/docs/

Then, simply, in you local workspace

$ bundle exec jekyll serve
...
 Auto-regeneration: enabled for '/Users/laiyingchun/dev/incubator-pegasus-website'
    Server address: http://127.0.0.1:4000
  Server running... press ctrl-c to stop.

You can preview the result by opening http://127.0.0.1:4000 in you browser.

  1. Submit the patch as a pullrequest

  2. The project managers will review the pullrequest soon, and will merge the PR if there is no problem.

acelyc111 avatar Dec 06 '23 08:12 acelyc111

Tasks

Feel free to leave a message in the task link if you want to assign it to yourself.

Translating

It's recommand to update the Chinese docs at first (if necessary), then translate it to English.

  • [x] https://github.com/apache/incubator-pegasus/issues/1806
  • [x] https://github.com/apache/incubator-pegasus/issues/1713
  • [x] https://github.com/apache/incubator-pegasus/issues/1714
  • [x] https://github.com/apache/incubator-pegasus/issues/1715
  • [x] https://github.com/apache/incubator-pegasus/issues/1716
  • [x] https://github.com/apache/incubator-pegasus/issues/1717
  • [ ] https://github.com/apache/incubator-pegasus/issues/1718
  • [ ] https://github.com/apache/incubator-pegasus/issues/1719
  • [ ] https://github.com/apache/incubator-pegasus/issues/1720
  • [ ] https://github.com/apache/incubator-pegasus/issues/1721
  • [ ] https://github.com/apache/incubator-pegasus/issues/1722
  • [ ] https://github.com/apache/incubator-pegasus/issues/1723
  • [x] https://github.com/apache/incubator-pegasus/issues/1724
  • [x] https://github.com/apache/incubator-pegasus/issues/1725
  • [x] https://github.com/apache/incubator-pegasus/issues/1726
  • [x] https://github.com/apache/incubator-pegasus/issues/1727
  • [ ] https://github.com/apache/incubator-pegasus/issues/1728
  • [x] https://github.com/apache/incubator-pegasus/issues/1729
  • [ ] https://github.com/apache/incubator-pegasus/issues/1730
  • [ ] https://github.com/apache/incubator-pegasus/issues/1731
  • [ ] https://github.com/apache/incubator-pegasus/issues/1732
  • [x] https://github.com/apache/incubator-pegasus/issues/1733
  • [x] https://github.com/apache/incubator-pegasus/issues/1734
  • [x] https://github.com/apache/incubator-pegasus/issues/1735
  • [ ] https://github.com/apache/incubator-pegasus/issues/1736
  • [ ] https://github.com/apache/incubator-pegasus/issues/1737
  • [ ] https://github.com/apache/incubator-pegasus/issues/1738
  • [ ] https://github.com/apache/incubator-pegasus/issues/1739
  • [ ] https://github.com/apache/incubator-pegasus/issues/1740
  • [ ] https://github.com/apache/incubator-pegasus/issues/1741
  • [ ] https://github.com/apache/incubator-pegasus/issues/1742
  • [ ] https://github.com/apache/incubator-pegasus/issues/1743
  • [ ] https://github.com/apache/incubator-pegasus/issues/1744
  • [x] https://github.com/apache/incubator-pegasus/issues/1745
  • [x] https://github.com/apache/incubator-pegasus/issues/1746
  • [ ] https://github.com/apache/incubator-pegasus/issues/1747
  • [x] https://github.com/apache/incubator-pegasus/issues/1748
  • [ ] https://github.com/apache/incubator-pegasus/issues/1749
  • [x] https://github.com/apache/incubator-pegasus/issues/1750
  • [x] https://github.com/apache/incubator-pegasus/issues/1751
  • [x] https://github.com/apache/incubator-pegasus/issues/1752
  • [ ] https://github.com/apache/incubator-pegasus/issues/1753
  • [ ] https://github.com/apache/incubator-pegasus/issues/1754

Website

  • [ ] Upgrade the framework
  • [ ] Improve the UI/UE
  • [ ] Adapt both desktop and mobile devices
  • [ ] You can add more tasks

Others

  • [ ] You can add more tasks

acelyc111 avatar Dec 06 '23 08:12 acelyc111