SPIMemory icon indicating copy to clipboard operation
SPIMemory copied to clipboard

The README is not readable anymore

Open polaroi8d opened this issue 7 years ago • 4 comments

GitHub issue state GitHub issue title GitHub issue author GitHub issue label GitHub issue comments GitHub issue age GitHub issue last update

---------------------------- DO NOT DELETE OR EDIT anything above this line ----------------------------

There are plenty of texts in the READ.ME, I think we can slice this text into a docs folder. Where it could be API documentation, Getting started description, pull request policy or anything else, and on the main READ.ME file there is only a few information about the project and the lib. Any suggestion?

polaroi8d avatar Apr 25 '18 21:04 polaroi8d

Hi mate, you are right. I've just finished getting the wiki up to date and was thinking of reducing the ReadMe to just basics and point to the wiki for the next release.

~~I have also been looking at trying to get the repo Doxygen compatible so everything stays up to date with in-line code comments. However I have not used doxygen previously and so it might take me a little time to figure out how it works.~~ 🙂

Also, I've recently discovered https://readthedocs.org/ and ~~might~~ will migrate the docs there ~~someday~~.

Marzogh avatar Apr 25 '18 23:04 Marzogh

Started the process of getting documentation in order through Sphinx and ReadTheDocs - as of commit 51512a3

Marzogh avatar Apr 26 '18 15:04 Marzogh

Nice work! If you can shift any of these tasks I can help you in my freetime.

polaroi8d avatar Apr 26 '18 20:04 polaroi8d

Thanks for the offer 👍 I've got whatever I have done to date on the development branch. Feel free to add to that if you have time and send in a pull request. 🙂

Just make sure you follow the same page format/design that I've already established - if you have ideas for improving that, feel free to let me know. I'm happy to take any suggestions for improvement on board. 😁

Marzogh avatar May 21 '18 00:05 Marzogh