You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/requirements/software-requirements.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,7 +27,7 @@ interpreted as described in [RFC
27
27
2. CLARIAH is registered as an [organization](https://github.com/CLARIAH) on github, any CLARIAH software project *MAY* be hosted there.
28
28
3. Git is *RECOMMENDED*
29
29
4. All content, including documentation, *SHOULD* be stored alongside the code in the VCS.
30
-
5. The source code repository *SHOULD* be publicly accessible from day 1 of development so interested third parties can follow development and provide feedback. The software code *MUST NOT* be reduced to a release/file-transfer mechanism for completed products. Exceptions are when code is under embargo or privacy-sensitive.
30
+
5. The source code repository *SHOULD* be publicly accessible from day 1 of development so interested third parties can follow development and provide feedback. The source code repository*MUST NOT* be reduced to a release/file-transfer mechanism for completed products. Exceptions are when code is under embargo or privacy-sensitive.
31
31
32
32
### 2. A README file *MUST* be provided in the root directory of the VCS
33
33
@@ -118,7 +118,7 @@ developers. The public support channel also gives an indication of community
118
118
interest in the project.
119
119
120
120
The only acceptable deviation to this rule is when the software is explicitly unmaintained
121
-
and unsupported, which must be clearly indicated in the README (see 1.3).
121
+
and unsupported, which must be clearly indicated in the README (see 2.3).
122
122
123
123
### 8. Software *SHOULD* be reusable
124
124
@@ -143,7 +143,7 @@ experimental software (see 1.3).
143
143
144
144
1. The VCS repository must have a ``codemeta.json`` file in the root directory containing basic high-level
145
145
software metadata. We adopt the [CodeMeta project](https://codemeta.github.io/) to this end. The ``codemeta.json`` file is a JSON-LD file that is machine-parseable and may be
146
-
used by metadata harvesters, for inclusion in e.g. Ineo. Moreover, it enable citability of the
146
+
used by metadata harvesters, for inclusion in e.g. Ineo. Moreover, it enables citability of the
147
147
software. The codemeta file can be in part automatically generated from the metadata you already
148
148
provided for your packages (see point 5)
149
149
@@ -160,7 +160,7 @@ documentation *SHOULD* be served on a website (platforms like readthedocs.io *MA
160
160
5. The use of API documentation as integral part of the code and tools such as doxygen, sphinx is *RECOMMENDED*.
161
161
162
162
Deviations to this rule are for unsupported/proof-of-concept/experimental software, which must be clearly indicated in
163
-
the README (see 1.3).
163
+
the README (see 2.3).
164
164
165
165
### 12. Software *MUST* have a clear maintainer
166
166
@@ -224,7 +224,7 @@ local Mac or Windows machine.
224
224
turn configures applications through environment variables (see [IR4](infrastructure-requirements.md#4-the-infrastructure-configures-applications-through-environment-variables-must-have-sep) and also related to point 7).
225
225
4. Containers should output all log information to ``stdout`` so it can be captured by the infrastructure (see IR5 and
226
226
IR6).
227
-
5. Application data (state) that needs to be persistant between runs *MUST* be stored separate from the container (e.g. in a
227
+
5. Application data (state) that needs to be persistent between runs *MUST* be stored separate from the container (e.g. in a
228
228
mounted volume) (See point 3 of the [Infrastructure Requirements (IR)](infrastructure-requirements.md))
229
229
230
230
### 15. Service developers *SHOULD* provide an initial template when multi-container orchestration is needed
0 commit comments