update documentation

This commit is contained in:
Sam 2022-07-23 11:56:03 +02:00
parent 9ab325c438
commit 808cad0729
4 changed files with 59 additions and 12 deletions

View File

@ -710,16 +710,22 @@ Installation
For evaluation purposes, docker files are available, installing **FitTrackee** from **sources**. For evaluation purposes, docker files are available, installing **FitTrackee** from **sources**.
- To install **FitTrackee** with database initialisation and run the application and dramatiq workers: - To install **FitTrackee**:
.. code-block:: bash .. code-block:: bash
$ git clone https://github.com/SamR1/FitTrackee.git $ git clone https://github.com/SamR1/FitTrackee.git
$ cd FitTrackee $ cd FitTrackee
$ cp .env.docker .env $ cp .env.docker .env
$ make docker-build docker-run docker-init $ make docker-build
Open http://localhost:5000 and register. - To initialise database:
.. code-block:: bash
$ docker-init
- Open http://localhost:5000 and register.
Open http://localhost:8025 to access `MailHog interface <https://github.com/mailhog/MailHog>`_ (email testing tool) Open http://localhost:8025 to access `MailHog interface <https://github.com/mailhog/MailHog>`_ (email testing tool)
@ -772,4 +778,13 @@ Development
Open http://localhost:3000 Open http://localhost:3000
.. note:: .. note::
Some environment variables need to be updated like `UI_URL` Some environment variables need to be updated like `UI_URL`
- to run lint or tests:
.. code-block:: bash
$ make lint-client # run lint on javascript files
$ make test-client # run unit tests on Client
$ make lint-python # run type check and lint on python files
$ make test-python # run unit tests on API

View File

@ -996,15 +996,23 @@ server {
</div> </div>
<p>For evaluation purposes, docker files are available, installing <strong>FitTrackee</strong> from <strong>sources</strong>.</p> <p>For evaluation purposes, docker files are available, installing <strong>FitTrackee</strong> from <strong>sources</strong>.</p>
<ul class="simple"> <ul class="simple">
<li><p>To install <strong>FitTrackee</strong> with database initialisation and run the application and dramatiq workers:</p></li> <li><p>To install <strong>FitTrackee</strong>:</p></li>
</ul> </ul>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ git clone https://github.com/SamR1/FitTrackee.git <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ git clone https://github.com/SamR1/FitTrackee.git
$ <span class="nb">cd</span> FitTrackee $ <span class="nb">cd</span> FitTrackee
$ cp .env.docker .env $ cp .env.docker .env
$ make docker-build docker-run docker-init $ make docker-build
</pre></div> </pre></div>
</div> </div>
<p>Open <a class="reference external" href="http://localhost:5000">http://localhost:5000</a> and register.</p> <ul class="simple">
<li><p>To initialise database:</p></li>
</ul>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ docker-init
</pre></div>
</div>
<ul class="simple">
<li><p>Open <a class="reference external" href="http://localhost:5000">http://localhost:5000</a> and register.</p></li>
</ul>
<p>Open <a class="reference external" href="http://localhost:8025">http://localhost:8025</a> to access <a class="reference external" href="https://github.com/mailhog/MailHog">MailHog interface</a> (email testing tool)</p> <p>Open <a class="reference external" href="http://localhost:8025">http://localhost:8025</a> to access <a class="reference external" href="https://github.com/mailhog/MailHog">MailHog interface</a> (email testing tool)</p>
<ul class="simple"> <ul class="simple">
<li><p>To set admin rights to the newly created account, use the following command line:</p></li> <li><p>To set admin rights to the newly created account, use the following command line:</p></li>
@ -1057,6 +1065,15 @@ $ make docker-build docker-run docker-init
<p class="admonition-title">Note</p> <p class="admonition-title">Note</p>
<p>Some environment variables need to be updated like <cite>UI_URL</cite></p> <p>Some environment variables need to be updated like <cite>UI_URL</cite></p>
</div> </div>
<ul class="simple">
<li><p>to run lint or tests:</p></li>
</ul>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>$ make lint-client <span class="c1"># run lint on javascript files</span>
$ make test-client <span class="c1"># run unit tests on Client</span>
$ make lint-python <span class="c1"># run type check and lint on python files</span>
$ make test-python <span class="c1"># run unit tests on API</span>
</pre></div>
</div>
</section> </section>
</section> </section>
</section> </section>

File diff suppressed because one or more lines are too long

View File

@ -710,16 +710,22 @@ Installation
For evaluation purposes, docker files are available, installing **FitTrackee** from **sources**. For evaluation purposes, docker files are available, installing **FitTrackee** from **sources**.
- To install **FitTrackee** with database initialisation and run the application and dramatiq workers: - To install **FitTrackee**:
.. code-block:: bash .. code-block:: bash
$ git clone https://github.com/SamR1/FitTrackee.git $ git clone https://github.com/SamR1/FitTrackee.git
$ cd FitTrackee $ cd FitTrackee
$ cp .env.docker .env $ cp .env.docker .env
$ make docker-build docker-run docker-init $ make docker-build
Open http://localhost:5000 and register. - To initialise database:
.. code-block:: bash
$ docker-init
- Open http://localhost:5000 and register.
Open http://localhost:8025 to access `MailHog interface <https://github.com/mailhog/MailHog>`_ (email testing tool) Open http://localhost:8025 to access `MailHog interface <https://github.com/mailhog/MailHog>`_ (email testing tool)
@ -772,4 +778,13 @@ Development
Open http://localhost:3000 Open http://localhost:3000
.. note:: .. note::
Some environment variables need to be updated like `UI_URL` Some environment variables need to be updated like `UI_URL`
- to run lint or tests:
.. code-block:: bash
$ make lint-client # run lint on javascript files
$ make test-client # run unit tests on Client
$ make lint-python # run type check and lint on python files
$ make test-python # run unit tests on API