jamulussoftware / jamuluswebsite

This is the GitHub Pages repository for the Jamulus main website. For the jamulus application source code, please visit jamulussoftware/jamulus.
https://jamulus.io
GNU Lesser General Public License v2.1
15 stars 82 forks source link

Standardising Style and Tone #339

Closed gilgongo closed 3 years ago

gilgongo commented 3 years ago

Use/copy a guide that we like and refer to that in order to resolve questions when writing documentation. Add our own bits and pieces along the way (eg BE spelling/grammar, how to refer to "open source", and whatever)

mulyaj commented 3 years ago

Here's a draft I've made. Let me know your thoughts!

gilgongo commented 3 years ago

Thinking about where to put this on the site, if we create wiki/en/en-Style-Guide.md and link to it from here that would work I think?

hoffie commented 3 years ago

Could we add an additional word of context? wiki/en/en-Language-Style-Guide.md? wiki/en/en-Doc-Style-Guide.md? I'm asking because there is also the topic of Code Style Guide (although I'm not saying that there will be such a document for that shortly).

mulyaj commented 3 years ago

We could probably add a link to it from Contribution.md.

ann0see commented 3 years ago

Just found the Google Doc again. https://docs.google.com/document/d/12-QJXRskXhiJ9F5HCl216h53OtGkXhReMnm2wrbtQpk/edit

Will link it on my PR.

ann0see commented 3 years ago

Closing since we now have a style guide on the website: https://jamulus.io/contribute/Style-and-Tone