How to edit Wiki section (#84)

* Warning do not edit Wiki

* Update Contributing.md

* Update _Sidebar.md

* How to edit wiki

* How to edit Wiki
This commit is contained in:
Pavel Zhovner 2020-09-02 11:16:47 +03:00 committed by GitHub
parent adfebf502f
commit 20f339665a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 21 additions and 12 deletions

View File

@ -28,21 +28,28 @@ Good point to add something about yourself. Create [welcome issue](https://githu
* Some sections mark as `not documented`. There is some implementation and you can add some documentation here. * Some sections mark as `not documented`. There is some implementation and you can add some documentation here.
* If section of wiki has no mark, this is actual documentation for part of Flipper. * If section of wiki has no mark, this is actual documentation for part of Flipper.
## Wiki editing `(not implemented)` ## How to edit Wiki
All wiki files storage in main repository in `wiki` folder. You can change wiki by creating PR with `documentation` label. After merge to master, wiki contents copying to GitHub `Wiki` section. > ⚠️ **Do not edit Wiki direcrly in web-interface. Your changes will be lost after automatic rebuild**
1. Edit files in `wiki` and `wiki_static` files in your branch
2. Create PR with `documentation` label
3. Wait for automatic rebuild after merged in master branch
The [Wiki](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki) connected to this repostiry is automatically generated from `.md` files located in repository via Github Actions.
**Folder structure:**
```
.
├── wiki # Actual wiki pages in markdown format
├── wiki_static # Static files for wiki: images, pdf, samples
```
## Backlog ## Backlog
Some tasks were postponed, you can find it by tag [backlog](https://github.com/Flipper-Zero/flipperzero-firmware-community/issues?q=label%3Abacklog+), maybe you are ready to implement something of it. Some tasks were postponed, you can find it by tag [backlog](https://github.com/Flipper-Zero/flipperzero-firmware-community/issues?q=label%3Abacklog+), maybe you are ready to implement something of it.
### For maintainers
If you want to update wiki:
* Do not edit wiki directly on github!
* place `flipperzero-firmware-community.wiki` folder repo in main repo's root folder (do not add it to git!)
* call `./wiki-deploy.sh` srcipt
# Maintainers # Maintainers
@ -91,4 +98,4 @@ If you want to add some features or suggest some changes, do following steps:
### Large and static files storage (incomplete) ### Large and static files storage (incomplete)
_Maintainers of this page: [`@glitchcore`](https://github.com/glitchcore)_ _Maintainers of this page: [`@glitchcore`](https://github.com/glitchcore)_

View File

@ -1,4 +1,6 @@
_please, do not edit wiki directly in web-interface. Read [contrubution guide](Contributing#wiki-editing-not-implemented) for instruction_ ### ⚠️ Warning ⚠️
_Do not edit this Wiki in web-interface. Read [How to edit Wiki](Contributing#how-to-edit-wiki)_
# [Home](Home) # [Home](Home)
@ -39,4 +41,4 @@ _please, do not edit wiki directly in web-interface. Read [contrubution guide](C
* [U2F](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/U2F) * [U2F](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/U2F)
* [Tamagotchi](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Tamagotchi) * [Tamagotchi](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Tamagotchi)
* [USB](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/USB) * [USB](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/USB)
* [Plugins](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Plugins) * [Plugins](https://github.com/Flipper-Zero/flipperzero-firmware-community/wiki/Plugins)