Skip to content

Commit 6e2b263

Browse files
authored
docs: improve documentation (#76)
* docs: fix font-family loading style * docs: enhance plugin documentation according with current tutor version * docs: add indentation to code in list * docs: add badges status
1 parent 4203f47 commit 6e2b263

File tree

8 files changed

+52
-45
lines changed

8 files changed

+52
-45
lines changed

README.md

Lines changed: 29 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,16 @@
11
# TVM
22

3+
![Maintainance Badge](https://img.shields.io/badge/Status-Maintained-brightgreen)
4+
![Test Badge](https://img.shields.io/github/actions/workflow/status/edunext/tvm/.github%2Fworkflows%2Ftests.yml?label=Test)
5+
![GitHub Tag](https://img.shields.io/github/v/tag/edunext/tvm?label=Tag)
6+
7+
38
TVM is a tool that allows you to manage several Tutor development environments so that they work in isolation, and you can work on different projects with independent Tutor versions and configurations.
49

510
TVM is also the acronym for:
611

7-
- Tutor Version Manager: manages the version of Tutor.
8-
- Tutor enVironment Manager: for creating project-based environments with Tutor.
12+
- **Tutor Version Manager:** Handle the Tutor versions.
13+
- **Tutor enVironment Manager:** Create project-based environments with Tutor.
914

1015
# Installing TVM
1116

@@ -27,39 +32,42 @@ Create and activate a new project with the following steps:
2732

2833
1. Install the version of Tutor you want to use with TVM.
2934

30-
```bash
31-
tvm install <tutor-version>
35+
```bash
36+
tvm install <tutor-version>
3237

33-
# For example:
34-
# tvm install v14.0.0
35-
```
38+
# For example:
39+
# tvm install v14.0.0
40+
```
3641

3742
2. Create a new project with TVM.
3843

39-
```bash
40-
tvm project init <project-name> <tutor-version>
44+
```bash
45+
tvm project init <project-name> <tutor-version>
4146

42-
# For example:
43-
# tvm project init tvm-test v14.0.0
44-
```
47+
# For example:
48+
# tvm project init tvm-test v14.0.0
49+
```
4550

4651
3. Open the project folder.
4752

48-
```bash
49-
cd <project-name>
50-
```
53+
```bash
54+
cd <project-name>
55+
```
5156

5257
4. Activate the project environment.
5358

54-
```bash
55-
source .tvm/bin/activate
56-
```
59+
```bash
60+
source .tvm/bin/activate
61+
```
5762

5863
5. Run your project.
5964

60-
```bash
61-
tutor local quickstart
62-
```
65+
```bash
66+
tutor local launch
67+
```
68+
69+
> [!NOTE]
70+
> For Tutor versions <15, init a project with `tutor local quickstart`
6371
6472
You can start configuring and using your Tutor instance.
6573

docs/source/_static/css/custom.css

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,9 @@
1-
@font-face {
2-
font-family: "PoppinsRegular";
3-
src: url("https://energiasrenovables.edunext.io/asset-v1:energiasrenovables+er01+2022_T1+type@[email protected]") format('truetype');
4-
}
1+
@import url('https://fonts.googleapis.com/css2?family=Poppins&display=swap');
52

63

74
body {
85
padding-top: 0!important;
9-
font-family: "PoppinsRegular", serif;
6+
font-family: "Poppins", sans-serif;
107
width: 112% !important;
118
}
129

docs/source/index.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
TVM
22
####
33

4-
TVM is a tool that allows you to manage several Tutor development environments so that they work in isolation, and you can work on different projects with independent Tutor versions and configurations.
4+
TVM is a tool that allows you to manage several Tutor development environments so that they work in isolation, and you can work on different projects with independent Tutor version and configurations.
55

66
User Guide
77
-----------
@@ -17,7 +17,7 @@ User Guide
1717
Releases
1818
---------
1919

20-
The Releases are listed on the `Github release page <https://github.com/eduNEXT/tvm/releases>`_. And all notable changes to this project are documented in the `CHANGELOG <https://github.com/eduNEXT/tvm/blob/main/CHANGELOG.md>`_ file.
20+
The Releases are listed on the `Github release page <https://github.com/eduNEXT/tvm/releases>`_. All notable changes to this project are documented in the `CHANGELOG <https://github.com/eduNEXT/tvm/blob/main/CHANGELOG.md>`_ file.
2121

2222
Source code
2323
-----------
@@ -27,7 +27,7 @@ The complete source code for TVM is available on Github: https://github.com/eduN
2727
Support
2828
--------
2929

30-
To get support, go to the TVM Github discussion forum: https://github.com/eduNEXT/tvm/discussions
30+
Get support in the TVM Github discussion forum: https://github.com/eduNEXT/tvm/discussions
3131

3232
Contributing
3333
-------------

docs/source/tvm_advanced_information.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Advanced Information
33

44
TVM is the acronym for:
55

6-
- Tutor Version Manager: manages the version of Tutor.
7-
- Tutor enVironment Manager: for creating project-based environments with Tutor.
6+
- Tutor Version Manager: handles the version of Tutor.
7+
- Tutor enVironment Manager: creates project-based environments with Tutor.
88

99
To develop this tool, we separate the code into two apps accord the two meanings of TVM, and we use a `Hexagonal Architecture <https://en.wikipedia.org/wiki/Hexagonal_architecture_(software)>`_.

docs/source/tvm_quickstart.rst

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,8 @@ TVM works with Tutor for that reason the Tutor requirements are also the TVM req
1717
**Basic Requirements:**
1818

1919
- Software:
20-
- `Docker <https://docs.docker.com/engine/installation/>`_: v18.06.0+
21-
- `Docker Compose <https://docs.docker.com/compose/install/>`_: v1.22.0+
20+
- `Docker <https://docs.docker.com/engine/installation/>`_: v24.0.5+ (with BuildKit 0.11+)
21+
- `Docker Compose <https://docs.docker.com/compose/install/>`_: v2.0.0+
2222
- Hardware:
2323
- Minimum configuration: 4 GB RAM, 2 CPU, 8 GB disk space
2424
- Recommended configuration: 8 GB RAM, 4 CPU, 25 GB disk space
@@ -66,7 +66,9 @@ Step by Step
6666

6767
.. code-block:: bash
6868
69-
tutor local quickstart
69+
tutor local launch
70+
71+
.. note:: For Tutor versions <15, init a project with ``tutor local quickstart```
7072

7173

7274
Next Steps

docs/source/tvm_topic_guides/environment_manager.rst

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ Remove a Project Environment
3838
# tvm project remove v14.0.0@tvm-test
3939
4040
41-
.. note:: You can use the flag --prune to remove all the project folder. Ex: `tvm project remove v14.0.0@tvm-test --prune`
41+
.. note:: You can use the flag --prune to remove all the project folder. E.g. ``tvm project remove v14.0.0@tvm-test --prune``
4242

4343

4444
Activate a Project Environment
@@ -57,7 +57,7 @@ Deactivate a Project Environment
5757
tvmoff
5858
5959
60-
.. warning:: If you also have another environment like a python virtual environment, you need to deactivate each virtual environment in order. For example, if you have `(venv) [v12.2.0@project-name]`, you need to run `deactivate` and then `tvmoff`.
60+
.. warning:: If you also have another environment like a python virtual environment, you need to deactivate each virtual environment in order. For example, if you have ``(venv) [v12.2.0@project-name]``, you need to run ``deactivate`` and then ``tvmoff``.
6161

6262
List Environments and Projects
6363
--------------------------------
@@ -67,7 +67,7 @@ List Environments and Projects
6767
tvm list
6868
6969
70-
.. note:: You can use the flag -l or --limit and an integer to limit the output. Ex: `tvm list --limit 10`
70+
.. note:: You can use the flag -l or --limit and an integer to restrict the output. E.g. ``tvm list --limit 10``
7171

7272
Install Tutor Plugins
7373
----------------------
@@ -90,7 +90,7 @@ Pip
9090
pip install <plugin>
9191
9292
93-
.. note:: If you don't already have your project environment activated, you can activate it using `source .tvm/bin/activate`, and then you will be able to use the pip command.
93+
.. note:: If you don't already have your project environment activated, you can activate it using ``source .tvm/bin/activate``, and then you will be able to use the pip command.
9494

9595

9696
Uninstall Tutor Plugins
@@ -115,7 +115,7 @@ Pip
115115
pip uninstall <plugin>
116116
117117
118-
.. note:: If you don't already have your project environment activated, you can activate it using `source .tvm/bin/activate`, and then you will be able to use the pip command.
118+
.. note:: If you don't already have your project environment activated, you can activate it using ``source .tvm/bin/activate``, and then you will be able to use the pip command.
119119

120120

121121
Related

docs/source/tvm_topic_guides/version_manager.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ List Environments and Projects
8484
tvm list
8585
8686
87-
.. note:: You can use the flag -l or --limit and an integer to limit the output. Ex: `tvm list --limit 10`
87+
.. note:: You can use the flag -l or --limit and an integer to restrict the output. E.g. ``tvm list --limit 10``
8888

8989

9090
Install Tutor Plugins
@@ -108,7 +108,7 @@ Pip
108108
pip install <plugin>
109109
110110
111-
.. note:: If you don't already have your project environment activated, you can activate it using `source .tvm/bin/activate`, and then you will be able to use the pip command.
111+
.. note:: If you don't already have your project environment activated, you can activate it using ``source .tvm/bin/activate``, and then you will be able to use the pip command.
112112

113113

114114
Uninstall Tutor Plugins
@@ -133,7 +133,7 @@ Pip
133133
pip uninstall <plugin>
134134
135135
136-
.. note:: If you don't already have your project environment activated, you can activate it using `source .tvm/bin/activate`, and then you will be able to use the pip command.
136+
.. note:: If you don't already have your project environment activated, you can activate it using ``source .tvm/bin/activate``, and then you will be able to use the pip command.
137137

138138

139139
Related

docs/source/tvm_tutorials/creating_two_dev_env.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
Creating two development environments
22
######################################
33

4-
At the end of this Tutorial, you will have two different TVM Projects to have two development environments.
4+
At the end of this tutorial, you will have two different TVM projects in two separate development environments.
55

66
Step by Step
77
-------------
@@ -43,7 +43,7 @@ Step by Step
4343

4444
.. code-block:: bash
4545
46-
tutor dev quickstart
46+
tutor dev launch
4747
4848
#. Stop your project.
4949

@@ -59,7 +59,7 @@ Step by Step
5959
6060
#. Repeat steps 3 to 8 using the project-name and tutor-version you want.
6161

62-
.. note:: You can have as many projects as you want, but you can't have two projects with the same name and tutor version.
62+
.. note:: You can have as many projects as you want, but you can not have two projects with the same name and tutor version.
6363

6464
Next Steps
6565
-----------

0 commit comments

Comments
 (0)