...

Apparently, Sphinx can also support custom CSS and JS- thus further customization could be performed. However, the caveat being that this customization would need to be synced up between projects. If different projects used different layouts, functionality it defeats the purpose of standardization. 

Questionnaire For Hyperledger Documentation 

This questionnaire is meant to promote discussion regarding layout, accessibility, features and use-cases around Hyperledger documentation. 

Questionnaire: Hyperledger project documentation 

What features are most relevant to your project documentation page? 

1. Quick Start / Example Projects 
2. Key product features and functionality 
3. The ability for the user to spin up an instance 
4. All of the above 

What visual layout or aesthetic style is the best choice for your Hyperledger documentation page? 

1. Simple, plain visual layout 
2. A current / modern look and feel 
3. Visually stunning layout with more color options 
4. Visual Layout is not relevant to my documentation page

Are there any features you would like to add to your project documentation page? 

1. Buttons to allow for ease of use 
2. Tables, graphs, charts or explanatory design documents 
3. Styling, aesthetic or layout features 
4. Social Media links / Hyperledger community links 
5. None of the above
6. All of the above 

How important are unique style elements to your project for documentation usage? 

1. Uniqueness is very important for product adoption
2. Medium amount of importance 
3. Not very important, end users don't need unique style for documentation usage

Are there any features you would like to remove from  your project documentation page? 

1. Yes, I would remove some features 
2. No, the documentation has no extraneous data 

What content do you think is most important on a documentation page? 

1. Introduction to the actual product itself 
2. A Quick Start / Example Project 
3. Key Concepts (section / paragraph style explanations) 
4. Glossary of  Key Terms 
5. Code Snippets / Code Examples 
6. All of the above 

Where you like your project documentation to be stored? 

1. Readthedocs (current platform) 
2. Another documentation platform 
3. I don’t have a preference 

What layout do you prefer for your documentation landing page? 

1. Small concepts that link to details 
2. Many concepts that comprehensively reflect the project
3. No preference as to layout 

From an end-user experience, do you think your page  is visited by mostly one or more of the following? 

1. Business-facing users / General purpose users
2. Developers / Technical Users 

How much customization do you prefer for your documentation? 

1. Plain, not much customization
2. A bit, but generic themes are ok 
3. I want in depth personalization and customization 

How important are charts, graphs, and other visual documentation components? 

1. Very important for product adoption
2. Medium amount of importance 
3. Not very important 

Does your documentation page include Provide alt text or descriptions for non-text content (images)? 

1. Yes our page is fully accessible to persons with disabilities 
2. No, upgrades or additions can be made to img tags with alt text