Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create and Add web page for Board Hardware Documentation, posting test Blogs #18

Open
3 of 6 tasks
dhairyashah1 opened this issue Oct 29, 2022 · 12 comments
Open
3 of 6 tasks

Comments

@dhairyashah1
Copy link
Collaborator

dhairyashah1 commented Oct 29, 2022

This issue aims to create a separate dynamic webpage that hosts the documentation and README.mds along with some other features viz. Adding board information, 3D layout + Images, testing blogs. Site hosted on GitHub Pages

Suggestion -
Use jekyll - a simple site generator using gh-pages. Tutorials can be found here.
Ref - https://sravjti.in/sra-board-component/

Todo -

  • Fix any bugs in the current README.md description files
  • Add/Optimise any technical content
  • Create a different branch called gh-pages and then start contributing
  • Host a site including the above information for Board and Sensors - LSA and MPU
  • Another page or subsection to display blogs on debugging/ technical matter observed during the journey of Board development
  • Another page or subsection to display renders, 3d models, images and renders. Something like - https://yellow.home-assistant.io/yellow-v1.2-standard/

CC - @Dhruv454000 @ChinmayLonkar @Sidshx assign this issue to some SY

@dhairyashah1 dhairyashah1 changed the title Add web page for Board Hardware Documentation, posting test Blogs Create and Add web page for Board Hardware Documentation, posting test Blogs Oct 29, 2022
@SuperChamp234
Copy link
Member

SuperChamp234 commented Oct 31, 2022

@dhairyashah1 I can take on this issue. I'll start with removing any .md errors

Looks like there is documentation in the documentation folder as well as the main README.md as well as the sensors you've linked. Any other locations to be considered?

@dhairyashah1
Copy link
Collaborator Author

Yes, apart from the documentation and README.md files, a custom section for blogs to be created, basically create a folder containing many md files containing the blog content. These can be displayed under the Blog section on the web page.
Additionally, refer last 2 points of the tasklist.

@SuperChamp234
Copy link
Member

Task 1 done, moving on to next tasks

@dhairyashah1
Copy link
Collaborator Author

Pull request for fixing readme errors has been merged. Make another branch named gh-pages as suggested for the web page.

@dhairyashah1
Copy link
Collaborator Author

Update @SuperChamp234 ?

@SuperChamp234
Copy link
Member

Working on setting up hugo to host the blogs. Sorry for the delay, will make some progress asap.

@dhairyashah1
Copy link
Collaborator Author

Updates @SuperChamp234

@dhairyashah1
Copy link
Collaborator Author

@SuperChamp234 post the temporary link of the website created here.

@SuperChamp234
Copy link
Member

SuperChamp234 commented Jan 11, 2023

Here is the temporary deployment at: https://superchamp234.github.io/sra-board-hardware-design/

A few points to note about the deployment:

  1. Currently the Hugo Workflow copies the README.md, the LSA README as well as the MPU README, from their folders. If more files need to be added, the workflow will have to be changed(easy to do so).
  2. Currently using the hugo-book theme.
  3. All documentation assets must be placed in /documentation folder, as it is statically uploaded. Any other files will have to be explicitly uploaded by the action.
  4. Blog posts can be hosted too, please update about their requirement if needed.

@SuperChamp234
Copy link
Member

I shall now begin working on the display section, or the 6th Todo

@dhairyashah1
Copy link
Collaborator Author

Update @SuperChamp234

@dhairyashah1
Copy link
Collaborator Author

@SuperChamp234 updates? Points 5 and 6 are required as well. A section to display specific blogs or discussions and
#2

[ ] Another page or subsection to display renders, 3d models, images and renders. Something like - https://yellow.home-assistant.io/yellow-v1.2-standard/

this would be desired. Displaying blogs written in .md format would be good. One can also look towards showing prominent GitHub issues like #14. Expecting this work to be done ASAP.

CC - @ChinmayLonkar @Premraj02

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants