Interactive-Book
Interactive-Book copied to clipboard
Restructure README.md
Current Status:
The README.md file covers the following topics:
- Introduction the the project
- Setting up development environment on local
- Contribution history
- Overview of the Interactive Book (contents, architecture, etc.)
- Rules and guidelines for contributions
- Code structure
- Pop quiz introduction
- Plugins
- Jekyll Resources
which is a lot of content cluttered into one markdown file in my opinion.
Enhancement:
I believe it would add a lot more structure and clarity to any who visits this repository while finding their way around in order to the content they are looking for if we broke down the README.md file into separate markdown files, each covering a sub-topic. For example, we could have separate pages describing Contribution guidelines, Setting up the development environment, and so on.
The README.md would ofcourse also serve as a nav-map, redirecting the users to the pages they are most interested in.
Approaches:
There are two ways we could go about this:
- We could add the content as part of the repository's WIKI's.
- Create individual .md files that would be linked to from the README.md page.
I would like to work on this.
how about a directory with all markdown files in there? and we can have a universal markdown file which as you said link to all these files present in some specific directory.
I think we must go with the second option : separate md files
Thanks, working on it!
@schezfaz Let me know if you need any support or want to divide the task.