rusefi_documentation/HOWTO_contribute_to_documen...

58 lines
3.3 KiB
Markdown
Raw Normal View History

2019-12-30 07:53:14 -08:00
2019-12-30 09:09:58 -08:00
#### How to contribute to https://github.com/rusefi/rusefi_documentation
Step 1: Sign up or sign in to https://github.com
Step 2: Open https://github.com/rusefi/rusefi_documentation and click 'Fork' - this would produce your own fork/copy of rusefi_documentation which you can now edit right in your browser!
2020-04-20 07:45:52 -07:00
![editor](FAQ/github_online_editor.png)
2019-12-30 09:09:58 -08:00
Step 3: Edit your code and Commit changes using the button below the editor.
Step 4: Once you are ready to contribute your changes, hit 'New pull request' button on the main page of your fork.
This would produce a [Pull request like this](https://github.com/rusefi/rusefi_documentation/pull/3) in the official rusefi repository and your changes would probably soon become public!
https://github.com/rusefi/rusefi/blob/master/firmware/tunerstudio/rusefi.input
#### How to contribute to rusEfi TunerStudio project
Same as above, fork https://github.com/rusefi/rusefi and edit your local copy of
https://github.com/rusefi/rusefi/blob/master/firmware/tunerstudio/rusefi.input file
https://github.com/rusefi/rusefi/commit/9d9ae5a05499027b32ed76df3e7ee2e2e8240c31 is an example of how more help could be added
right into TunerStudio project file. Lines with green background are the lines being added.
Unfortunately while you would be modifying your mainController.ini file while trying your changes, you need to edit rusefi.input file which
is a template from which rusefi.ini is generated programmatically on rusefi side.
2019-12-30 07:53:14 -08:00
# Technical implementation details
Github Wiki is weird.
One the one hand, we have https://github.com/rusefi/rusefi_documentation - that's a git repository with nice pull
request process, but less nice web page rendering which start each folder by showing list of files, that's not what end users want to see.
On the other hand, we have https://github.com/rusefi/rusefi_documentation/wiki which is displayed much nicer - and
that https://github.com/rusefi/rusefi_documentation/wiki is actually implemented by ANOTHER git repository
https://github.com/rusefi/rusefi_documentation.wiki.git behind the scene. That https://github.com/rusefi/rusefi_documentation.wiki.git repository does not have a nice Pull Request process :(
Solution? A combination. Here at rusefi_documentation both repositories are actually set to mirror each other.
This way we have the nice Pull Request process on https://github.com/rusefi/rusefi_documentation and once changes are
merged into https://github.com/rusefi/rusefi_documentation, complete https://github.com/rusefi/rusefi_documentation is merged
into https://github.com/rusefi/rusefi_documentation.wiki.git which makes actual content nicely visible at https://github.com/rusefi/rusefi_documentation/wiki
2019-12-30 09:30:32 -08:00
# Technical FAQ
Q: Is it ok that https://github.com/rusefi/rusefi_documentation.wiki.git cannot be opened from browser?
A: There is no reason to open https://github.com/rusefi/rusefi_documentation.wiki.git from browser. Also while you technically
CAN "git clone https://github.com/rusefi/rusefi_documentation.wiki.git" and it would work -
you should NOT. Anyone looking to make changes should be making changes to non-wiki git via normal fork & pull request process.
Additional automation is in charge of merging from https://github.com/rusefi/rusefi_documentation.git into https://github.com/rusefi/rusefi_documentation.wiki.git