Rewrite the docs

[JuanjoSalvador]

Documentation seems a bit confused. We need to write a tutorial,how install Blask and how to start using it!

[zerasul]

You can use too the #55 issue.

[Amruta-Ranade]

I would like to help with the Getting Started docs!

[zerasul]

I would like to help with the Getting Started docs!

Hi Amruta; of course you can help only you need to do is send an Pull Request, and i will accept it later. Also, if you need more help, please ask what you need.

[Amruta-Ranade]

Thanks! I am planning a video documenting my writing process while contributing to open source projects. The intention is to help others contribute docs to open source projects. Is it okay if I document my writing process for the Getting Started guide?

[zerasul]

Hi!

Of course its okay to writting the process!! And any help that we can offer you, please ask us.

[Amruta-Ranade]

Hello..I am swamped with my day job-related work, but just wanted to let you know that I have started working on the docs for Blask in whatever free time I get. I hope to invest more time on this project once I get some more free time in the next few weeks.

[zerasul]

Hi Amruta:

Don't worry feel free to work when you can. And remember if you have any question, feel free to ask us,

Of course, thanks for your help.

[Amruta-Ranade]

Hello! I need help figuring out the commands to run the project. I tried following the instructions on the Install page, but got errors:

pip install blask gave the error:
Collecting blask
Could not fetch URL https://pypi.python.org/simple/blask/: There was a problem confirming the ssl certificate: [SSL: TLSV1_ALERT_PROTOCOL_VERSION] tlsv1 alert protocol version (_ssl.c:661) - skipping
Could not find a version that satisfies the requirement blask (from versions: )
No matching distribution found for blask

pip install -r requirements.txt gave the error:
Could not open requirements file: [Errno 2] No such file or directory: 'requirements.txt'

Can you help me figure out the correct commands?

[JuanjoSalvador]

The first pip error seems a error with the PIP itself. Can you tell us the version of pip are you using?

pip --version

And the second error, maybe it's because you have to clone the repo and move into it

git clone https://github.com/zerasul/blask.git && mv blask

[Amruta-Ranade]

Thanks for the quick response!

The pip version I am using is: pip 9.0.1 from /Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages (python 2.7)

About cloning the repo, the instructions indicated that cloning the repo was an optional step. Am I mistaken? 🤔

[Amruta-Ranade]

I realized I was using python2.7 instead of python3. I used pip3 instead of pip, and it worked fine! :)

[Amruta-Ranade]

I created the settings.py file and tried running blaskcli init and blaskcli run (The docs say I can use the cli command because I installed blask using pip). Getting the following error:

Traceback (most recent call last):
File "/Library/Frameworks/Python.framework/Versions/3.6/bin/blaskcli", line 11, in
load_entry_point('Blask==0.1.0', 'console_scripts', 'blaskcli')()
File "/Library/Frameworks/Python.framework/Versions/3.6/lib/python3.6/site-packages/pkg_resources/init.py", line 565, in load_entry_point
return get_distribution(dist).load_entry_point(group, name)
File "/Library/Frameworks/Python.framework/Versions/3.6/lib/python3.6/site-packages/pkg_resources/init.py", line 2631, in load_entry_point
return ep.load()
File "/Library/Frameworks/Python.framework/Versions/3.6/lib/python3.6/site-packages/pkg_resources/init.py", line 2291, in load
return self.resolve()
File "/Library/Frameworks/Python.framework/Versions/3.6/lib/python3.6/site-packages/pkg_resources/init.py", line 2297, in resolve
module = import(self.module_name, fromlist=['name'], level=0)
File "/Library/Frameworks/Python.framework/Versions/3.6/lib/python3.6/site-packages/Blask/blaskcli.py", line 44, in
blask = BlaskApp()
File "/Library/Frameworks/Python.framework/Versions/3.6/lib/python3.6/site-packages/Blask/blaskapp.py", line 36, in init
self.settings = BlaskSettings(**kwargs)
File "/Library/Frameworks/Python.framework/Versions/3.6/lib/python3.6/site-packages/Blask/blasksettings.py", line 48, in init
0)
ModuleNotFoundError: No module named 'settings'