Skip to content

Commit acb5058

Browse files
authored
Merge pull request #10 from hayco/patch-1
Update software-requirements.md
2 parents f9014bd + 56de56f commit acb5058

1 file changed

Lines changed: 5 additions & 5 deletions

File tree

docs/requirements/software-requirements.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ interpreted as described in [RFC
2727
2. CLARIAH is registered as an [organization](https://github.com/CLARIAH) on github, any CLARIAH software project *MAY* be hosted there.
2828
3. Git is *RECOMMENDED*
2929
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.
3131

3232
### 2. A README file *MUST* be provided in the root directory of the VCS
3333

@@ -118,7 +118,7 @@ developers. The public support channel also gives an indication of community
118118
interest in the project.
119119

120120
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).
122122

123123
### 8. Software *SHOULD* be reusable
124124

@@ -143,7 +143,7 @@ experimental software (see 1.3).
143143

144144
1. The VCS repository must have a ``codemeta.json`` file in the root directory containing basic high-level
145145
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
147147
software. The codemeta file can be in part automatically generated from the metadata you already
148148
provided for your packages (see point 5)
149149

@@ -160,7 +160,7 @@ documentation *SHOULD* be served on a website (platforms like readthedocs.io *MA
160160
5. The use of API documentation as integral part of the code and tools such as doxygen, sphinx is *RECOMMENDED*.
161161

162162
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).
164164

165165
### 12. Software *MUST* have a clear maintainer
166166

@@ -224,7 +224,7 @@ local Mac or Windows machine.
224224
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).
225225
4. Containers should output all log information to ``stdout`` so it can be captured by the infrastructure (see IR5 and
226226
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
228228
mounted volume) (See point 3 of the [Infrastructure Requirements (IR)](infrastructure-requirements.md))
229229

230230
### 15. Service developers *SHOULD* provide an initial template when multi-container orchestration is needed

0 commit comments

Comments
 (0)