girlscript_app icon indicating copy to clipboard operation
girlscript_app copied to clipboard

Documentation

Open smaranjitghose opened this issue 5 years ago • 5 comments

Use Sphinx to document the project in readthedocs format.

Suggested Content:

  • The main page should be description of the project
  • Detailed Table of contents
  • Separate page for contributors
  • Dedicated sections for each page of the app with all the necessary cards should be so that anyone with very less or no knowledge of flutter can use this app by changing certain lines of code
  • Instructions for Firebase Integration (Don't include the api keys)
  • How to update the project from Firebase
  • How to build separate Android and IOS Apps
  • How to make an .apk file and publish to PlayStore

Push this to gh-pages branch

smaranjitghose avatar Apr 27 '20 23:04 smaranjitghose

I would like to work on this as part of GSSoC 20. I'm new to technical writing. Some resources and help from the mentors will be very much appreciated!

CipherGirl avatar May 04 '20 14:05 CipherGirl

I am a GSSoC 20 participant. Can I be assigned to this issue?

Shadman-Ahmed-Chowdhury avatar May 04 '20 15:05 Shadman-Ahmed-Chowdhury

@CipherGirl @Shadman-Ahmed-Chowdhury Divide the work among yourself.

Go through the youtube videos on sphinx Documentation (PyCon,Enthought,PyData)

smaranjitghose avatar May 06 '20 06:05 smaranjitghose

Hello @smaranjitghose, Thank you for assigning to us. I have been setting up the project on my machine and watched some sphinx tutorials also. I have some queries:

  • Are we required to know flutter to contribute to this issue?
  • We need the initial set up for the docs. The branch 'gh-pages' is not set up. Can you please help us with it?
  • Kindly elaborate on this section -> "Dedicated sections for each page of the app with all the necessary cards should be so that anyone with very less or no knowledge of flutter can use this app by changing certain lines of code".

CipherGirl avatar May 09 '20 14:05 CipherGirl

Hello @smaranjitghose, Thank you for assigning to us. I have been setting up the project on my machine and watched some sphinx tutorials also. I have some queries:

  • Are we required to know flutter to contribute to this issue?
  • We need the initial set up for the docs. The branch 'gh-pages' is not set up. Can you please help us with it?
  • Kindly elaborate on this section -> "Dedicated sections for each page of the app with all the necessary cards should be so that anyone with very less or no knowledge of flutter can use this app by changing certain lines of code".
  • Yes you need to understand fundamentals of flutter to write the documentation as you would be explaining the various cards and functions
  • I have set up the branch
  • Basically the aim of the documentation is to help anyone with no knowledge of flutter or app dev to use this code, make changes in content and assets in certain places of the codebase and use this app as their own

smaranjitghose avatar May 11 '20 21:05 smaranjitghose