BYU-Idaho CS 364 Software Engineering Class
This github repository is for the storage of and collection of research material, versioning of the content as we develop our documents and the ability to deliver our final Software Requirements Specification and Software Design Documents.
I recommend that we utilize the Markdown script during our research and development phase of the project.
It will provide a number of benifits that will help in focusing on the key tasks at hand. First, it will allow us
to focus on the text and less on formatting. Second, it will allow the ability to easily version the content that is being
created and developed. If there are any issues we can quickly revert or review old versions of what we're working on. Third,
allows each of us to use the editor tool of our choice during the research phase of the SRS and SDD. Lastly, we'll be able
to create a full draft version of our final document quickly and easily.
https://guides.github.com/pdfs/markdown-cheatsheet-online.pdf
https://enterprise.github.com/downloads/en/markdown-cheatsheet.pdf
Please look for my example found under research for using Markdown script, text, and images.
Creating the final document from the markdown script will be fairly easy to do, in draft form. The basic structure, titles, headers, will easily be represented using the Markdown script including images, tables, etc. Spelling and other issues can be verified and corrected once it has been migrated over to Microsoft Word.
During research and development of the SRS and SDD the documents can be segmented into various sections to facilitate the ease of access to all Team Members. By creating a document list structure we can break out each section by name and section allowing us to group all documents together quickly and easily. This will should allow for document tracking quickly and easily. Breaking sections out using hierarchical structure of numbers will then also allow keeping each section separate but grouped by its numbering sequence and creating a natural sorted order on disk.
1.0.0.0.md
1.1.0.0.md
1.1.1.0.md
1.1.2.0.md
1.2.0.0.md
1.2.1.0.md
1.2.1.1.md
etc.
https://en.wikipedia.org/wiki/Collaborative_writing
http://writingcenter.unc.edu/tips-and-tools/group-writing/