wiki/notebook/2021-05-09-17-30-43.org
Gabriel Arazas b088086b06 Merge evergreen notes into the notebook
Now, it's all under the notebook umbrella. Seems to be appropriate as it
is just my notes after all.

I also updated some notes from there. I didn't keep track of what it is
this time. Something about more learning notes extracted from my
"Learning how to learn" course notes and then some. Lack of time and
hurriness just makes it difficult to track but it should be under
version control already.
2021-07-21 16:28:07 +08:00

1.3 KiB

Make a style guide for consistency

Style guides are one of the most common things you'll see when collaborating whether in software, writing, or even in music. These dictate what forms are acceptable and how to do such things. Having a foundation for what to do and not to do creates less overhead for you and your collaborators. Prefer referencing over remembering.

Even for personal projects, these could come in handy especially if you have to handle it in the future. For example, you could keep in mind to Create examples of ranking complexity when documenting your project.

Writing style guides doesn't have to involve a separate document complete with details and nuances. They can be just a section in your README, for example. If you do have a complete document, one of the ways to ease introducing it is to create a summarized version of it and link the document for more information.

However, don't fall into obsession for minding every item not following the guidelines. Style guides are only meant for consistency first, not clarity. Obsessively applied writings could make less sense when read.