How to Contribute

At least at first stage we are going to collaborate via means of github.

Generated pages are placed at http://e-maxx-eng.appspot.com.

And sources (to which you may want to contribute) are here.

In order to make contribution consider the following steps:

  1. Fork source repository.
  2. Add or modify files in src subfolder in Markdown format (you can do this in web-interface of github now).
  3. Make sure you added <!--?title ... --> to your page and the corresponding link to main (index) page.
  4. Use Test-Your-Page form to check if you are satisfied with the result.
  5. Use pull-request feature to send the request for your changes to be merged.
  6. It may take few hours or few days before someone who have admin rights will merge your request. Contact any of admins personally to speed up this process!
  7. After merging it will take about 5 minutes before updated html page will appear at the site.

You may start with this demo-article or even use its source as a template for your new article.

Please kindly refer to manuals on using git and github anywhere over internet. You may also watch this demo video:

Your Authorship is Preserved

Some contributors add explicit links to their profiles at the bottom of the translated articles. However it is discouraged and simply not very convenient if the article was edited by several people. Every page has Page Authors link in its top - this link leads to the github commit history, so it is always easy to determine or prove the authorship (even of any single line). Just make sure that your GitHub profile (which is mentioned in history) provides enough information about you.

Source format

We use Markdown for source texts and convert them automatically to HTML. Some extra features also could be used.

Formulas could be added thanks to MathJax library. Simply use TeX expressions inside single or double dollar marks $, for example:

here is an inline equation: $P \ne NP$

And here is the formula in the separate block:

$$E = mc^{2}$$

Some conventions

Adding images

Small images could be pushed along with texts to the /img subfolder. Let them be in PNG format and less than 200kb. Then you can refer to them inside the article with the tag:

![some image description](&imgroot&/my-image.png)

Here my-image.png should be your file name, while &imgroot& is some magic which will expand to proper url prefix when shown at the site (so you need not know the precise prefix of github raw data).

Larger images should be posted to some image-hosting, like PostImage or ImgUr - they will then give you the url to insert into the page.