Contribution au Wiki

Un guide pour mettre à jour le Wiki 1Hive.

1Hive est un vaste écosystème contenant de nombreux projets différents qui sont continuellement en développement. Le maintien d'un wiki est important pour s'assurer qu'il y a un aperçu concis de l'état de 1hive. Tout le monde est encouragé à contribuer au wiki 1Hive.

Au moins un membre de chaque essaim aura un accès en écriture pour mettre à jour le wiki afin de s'assurer que les détails sur son essaim et les projets associés sont exacts. Toute personne sans accès en écriture peut toujours mettre à jour une page sur le wiki, ou la structure du wiki, via Github en utilisant une pull request.

Editer le Wiki avec Github Editer

First Time Setup Steps

  1. To edit a page without explicit write access requires a Github account. Create one here: http://github.com/

  2. Fork the Wiki from the 1Hive Github organisation to your own Github account by going to this link and clicking fork in the top right: https://github.com/1Hive/wiki

Post Setup Steps

  1. Within the Wiki repo that was forked to your own Github account, navigate to the file you wish to change and edit the file directly in your web browser by clicking on the pencil icon in the top right of the files border. Each file represents a page on the wiki, the names should represent those seen through the Wiki website.

  2. Use Github markdown to format your entry: https://guides.github.com/features/mastering-markdown/

  3. If adding a new page, make sure you link to it from the SUMMARY.md file in the root directory to include it in the menu.

  4. Commit your change by scrolling to the bottom, entering a commit message and clicking Commit.

  5. Create a pull request (PR) against the 1hive wiki repo by clicking on Pull Requests -> New Pull Request. Note the base repository should be 1Hive/wiki and the base should be master. Click Create Pull Request.

  6. Enter a title and description about your change and click Create Pull Request.

  7. You have successfully created a PR on the 1Hive wiki repo. You must now wait for it to be reviewed by a member of the 1Hive Github organisation. Reviewers may leave comments so be sure to check your emails and or check back to see if you need to respond.

  8. If you need to update your changes due to reviewer comments, update the file as you did to begin with and they should be reflected in the PR.

  9. Once the PR is considered acceptable it will be merged into the wiki by a reviewer.

Last updated