User Tools

Site Tools


documentation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
documentation [2024/10/07 20:40] pauldocumentation [2024/12/09 03:21] (current) paul
Line 1: Line 1:
-====== Drafts ======+====== Documentation ======
  
-If you want to help, take a look at the DRAFTS_TO_EDIT page, which lists drafts that need feedback.+===== Drafts =====
  
-Please read FEEDBACK.+If you want to help, take a look at the [[documentation:paginated_drafts_to_edit|Printed Docs to Edit]] page, which lists drafts of printable material that need feedback.
  
-If you want to build new documentation, see CONTRIBUTING_TO_DOCS.+If you want to build new documentation, see CONTRIBUTING_TO_DOCS. (Forthcoming)
  
-====== Deployment Plan ======+===== Deployment Plan =====
  
 The website is purposed for offering all public information. The website is purposed for offering all public information.
Line 15: Line 15:
 Here are the steps we need to take to set up BookStack: Here are the steps we need to take to set up BookStack:
  
-  - Stand up a BookStack instance +  - Stand up a BookStack instance (done) 
-  - Enable and test SSO +  - Enable and test SSO (done) 
-  - Populate BookStack instance with dummy content +  - Populate BookStack instance with dummy content (done) 
-  - Start meta documentation book +  - Start meta documentation book (done) 
-  - Test permissions and access control +  - Test permissions and access control (done) 
-  - Document permissions and access control+  - Document permissions and access control 
   - Make a backup   - Make a backup
   - Document making a backup   - Document making a backup
   - Restore from the test backup and make sure it works   - Restore from the test backup and make sure it works
   - Document restoring from a backup   - Document restoring from a backup
-  - Build out stub shelves for audience types +  - Build out stub shelves for audience types (done) 
-  - Build out stub books for documentation categories+  - Build out stub books for documentation categories (done)
   - Set permissions as appropriate (map members to groups)   - Set permissions as appropriate (map members to groups)
   - Test permissions.   - Test permissions.
  
-====== Information Architecture ======+===== Information Architecture =====
  
-TEMPLATES for various Documentation. (link forthcoming)+Notes on [[documentation:organization|Organizing the Documentation]].
  
-ORGANIZATION notes. (link forthcoming)+Notes on the content, structure, and templates for various document types:
  
 +Full documents:
 +
 +  * [[documentation:structure:class_handouts|Class Handouts]]
 +  * Shop Binders
 +
 +Partial documents for inclusion as parts of full documents:
 +
 +  * [[documentation:structure:tool_usage_guide|Tool Usage Guides]]
 +  * [[documentation:structure:software_guide|Software Guides]]
 +  * [[documentation:structure:concept_guide|Concept Guides]]
 +
 +===== Other Notes =====
 +
 +  * [[documentation:production_notes|Production Notes]]
 +  * [[documentation:content_notes|Content Notes]]
  
documentation.1728333647.txt.gz · Last modified: 2024/10/07 20:40 by paul