DEV Community

Cover image for Season Of Docs, Meeting-4
Prubhtej Singh
Prubhtej Singh

Posted on • Updated on

Season Of Docs, Meeting-4

On 16th of September, I had a meeting with my mentors regarding my Google's Season Of Docs project.
The following tasks were assigned to me:-

  1. Correcting the section order of the menu on the LHS of synbiohub.github.io

  2. Provide correct links to the broken ones in the About SynBioHub and the references section.

  3. Renaming the "Further References" section to the "References" section.

  4. Moving the Plugins from the Installation section to the Plugins section and reconfiguring the table using Go-lang templates and partials provided by Hugo.

  5. Changing the docker-installation to something more appropriate.

  6. Include installation instructions for Mac OS and Linux OS to the installation section.

  7. Remove all the content from the Source installation section and provide a link to the github repository.

  8. Make a separate section for Setup and add some content to it, i.e. about Web-Of-Registries and SendGrid Mail setup.

  9. Go through the doc on plugins sent by Jet.

  10. Try and prepare a doc on Information collected from the assync. research paper that can be included in the documentation.

I was able to accomplish the following tasks:-

  1. Provided correct links to the broken ones in the About SynBioHub section and the References section.

  2. Renamed the "Further References" section to the "References" section.

  3. Changed the docker installation to something more appropriate, though it still requires some improvement.

  4. Included the installation instructions to Mac OS and Linux-Ubuntu 20.04 to the installation section.

  5. Removed all the content from the Source installation section and gave the link to the github repo.

  6. Installed SynBioHub without any error on Ubuntu.

  7. Created a separate section for setup.

  8. Added a brief description about "Web-Of-Registries" to the Setup section.

The Problems that I've encountered this week are:-

  1. Couldn't re-order the menu. I tried to re-order the menu by allocating weight's to every section but surprisingly, it didn't do any good.

  2. Though I was able to move the plugins table from the "Installation" section, but unfortunately I was unable to understand & use the Go-lang template and partials provided by Hugo. I've opened a few PR's on Hugo's repo and I'm hoping to find a feasible solution in the next couple of days.

  3. Wanted to Upload a design to synbiohub.org but was unable to find the link to the repo from which I was to copy the designs.

  4. Was unable to go through the doc sent by Jet fully. Though, I was able to go through the first few pages and had a few doubts.

Hope I'll be able to clarify the doubts that I have and plan tasks for the upcoming week in the next week.

Top comments (0)