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

Technical Documentation Website #31

Open
1 task
smaranjitghose opened this issue Jan 6, 2021 · 7 comments
Open
1 task

Technical Documentation Website #31

smaranjitghose opened this issue Jan 6, 2021 · 7 comments
Labels
DWOC DevScript Winter of Code 2020 SWoC2021 Script Winter of Code 2021

Comments

@smaranjitghose
Copy link
Owner

Requirements:

  • Home Page:
    • Information about Project
    • Open Source :
      - Programs we are a part of: info about SLOP, SWOC,DWOC
      - Contribution Guide
      - Code of Conduct
      - License
    • Team
      - Project Maintainer
      - Project Contributor
  • Getting Started:
    - Using this repo as a template on GitHub
    - Getting the source code locally
    - Model Integration
    - Updating Model Files
    - Updating the Image Classifier Script
    - Front End Changes
    - Home Page [ Of the app] -
    - Team Page
    - About Page
    - Firebase and more Pages!
    - Setup Firebase for the project
    - Store Configuration Files to reference Firebase Project
    - Setup Real time database for the project
    - Update the Contact Page
    - Setup Cloud Storage for the project -
    - Update the function to send images -
    - Remove Firebase(If not required)
  • Deployment
    - Staging, Commiting and Pushing Changes to GitHub
    - Cloud Services:
    - Heroku
    - Google Cloud Services
    - Amazon Web Services -
    - Microsoft Azure
    - Digital Ocean
    - Linode
    - Python Everywhere

Directions:

  • Package to be used: mkdocs
  • Template to be followed: Material
  • Branch to be pushed: gh-pages [the deploy], master[the docs/ directory inside which the documentation would be present] - Please gitignore everything under site/

References:

NOTE:

  • Please only take up the this issue once you are fully comfortable with using and hosting docs with mkdocs.
  • This issue is not be done all at once but in various parts. Whenever you comment interested, just specify which part of the documentation you want to build
  • If the information for the part is not available, please wait for it be available (like Guide for Digital Ocean), this issue has be worked upon in parallel with the others. Only take up tasks for which the information is updated
  • The source code to a similar documentation is already given above, and feel free to use YouTube for learning
@smaranjitghose smaranjitghose added DWOC DevScript Winter of Code 2020 SWoC2021 Script Winter of Code 2021 labels Jan 6, 2021
@raman08
Copy link

raman08 commented Jan 11, 2021

I would like to work on this issue

@smaranjitghose
Copy link
Owner Author

Any updates @raman08 ?

@raman08
Copy link

raman08 commented Jan 14, 2021

Yes, I have setup the environment and just arranging the files

@raman08
Copy link

raman08 commented Jan 15, 2021

Sir I have buid a basic site, but I have a doubt
Should I copy all the documentation to the docs/ folder or something else

@raman08
Copy link

raman08 commented Jan 15, 2021

Sir, I have made a sample navigation bar as per the above requirement. and placed the Guides folder inside the docs folder. ANd link all the available pages to their respective link

@raman08
Copy link

raman08 commented Jan 15, 2021

Should I pull the changes??

@smaranjitghose
Copy link
Owner Author

@raman08 Please follow the changes suggested in the PR

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
DWOC DevScript Winter of Code 2020 SWoC2021 Script Winter of Code 2021
Projects
None yet
Development

No branches or pull requests

2 participants