contributors templates documentation

[LeBaronDeCharlus]

@spenserblack, @o2sh can this help ?

[LeBaronDeCharlus]

I've also seen this method on other repos (if it might help?)

• [you] create a onefetch/template repo (where you put basically the skeleton markdown template)
• [contributor] will create a repo on their own & leave it empty
• [contributor] add onefetch template as a remote: git remote add template [email protected]:onefetch/template.git
• [contributor] pull from it: git pull template main --depth=1
• [contributor] delete the remote: git remote remove template
• [contributor] then they can work directly with

Full example on Catppuccin https://github.com/catppuccin/catppuccin/blob/main/docs/contributing.md#creation

[spenserblack]

I've also seen this method on other repos (if it might help?) ...

That's a pretty interesting solution! I'll have to think about the best way to accomplish this, but I'd like to make it as easy for contributors as possible. Thinking purely from a contributor workflow, something like this:

1. fork onefetch
2. create a file like fr.translation.<extension> (maybe YAML?)
3. make PR

And on our end something like this: on push to main with path docs/translations: parse values from translation file to template

Besides ease of contributing, my secondary goal (OK, maybe actually primary :sweat_smile:) is to reduce duplicated work as much as possible (e.g. changing image links). This does add some complication to the repo though, possibly enough to warrant a separate docs repo, so it may not be worth it.

Edit: oh, nevermind, we won't need a separate repo because there could be an orphaned branch like gh-pages. Totally forgot about that :sweat_smile: :facepalm:

[o2sh]

This pull request has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs.