Formatting

swentry.org

@@ -3,22 +3,17 @@
 We need a proposition for a software bibtex output to meet several demands
 from different services provided by Inria infrastructure:
 
-- HAL's software deposits
-- RAWEB activity report
+- software deposit in HAL
+- generation of RAWEB activity report
 
-
-** Entry description
-
-The field description is based on 
-[[http://mirrors.ibiblio.org/CTAN/macros/latex/exptl/biblatex/doc/biblatex.pdf][biblatex documentation]]
+** Field description
+The field description is based on the [[http://mirrors.ibiblio.org/CTAN/macros/latex/exptl/biblatex/doc/biblatex.pdf][biblatex documentation]]
 
 *** Mandatory fields
-    - author :: list (name). The authors of the title. see issue 
-        [[https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-entry/issues/6][#6]]
+    - author :: list (name). The authors of the title. See issue [[https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-entry/issues/6][#6]]
     - title :: field (literal). The title of the software artifact.
     - url :: field (uri). The url of an online publication (e.g on HAL).
-    - year :: field (literal). The year of creation or release. see issue 
-        [[https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-entry/issues/7][#7]]
+    - year :: field (literal). The year of creation or release. See issue [[https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-entry/issues/7][#7]]
 
 *** Optional fields
     - abstract :: field (literal). This field is intended for recording 
@@ -28,8 +23,7 @@ The field description is based on
         by the standard bibliography styles. Replaces PDF.
     - doi :: field (verbatim). The Digital Object Identifier of the work. 
     - hal_id [not in biblatex] :: field (verbatim). A digital identifier for the 
-        software record including its description and metadata on HAL. see issue 
-        [[https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-entry/issues/1][#1]].
+        software record including its description and metadata on HAL. See issue [[https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-entry/issues/1][#1]].
     - license [not in biblatex] :: list (literal). The license/s of the title 
         in SPDX format.
     - month :: field (literal). The month of creation or release. This must be 
@@ -38,20 +32,16 @@ The field description is based on
     - institution :: field (literal). The institution(s) that took part in the 
         software project.
     - publisher :: list (literal). The name(s) of the publisher(s) of the software
-        record (we need to define the notion of a research software publisher- see issue 
-        [[https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-entry/issues/2][#2]]).
+        record (we need to define the notion of a research software publisher, see issue [[https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-entry/issues/2][#2]]).
     - repository [not in biblatex] :: field (uri). The url of the code repository 
         (e.g on GitHub, GitLab).
     - swh_id [not in biblatex] :: field (verbatim) The identifier of the digital
         object (a.k.a the software artifact itself). The intrinsic identifier
         of the item is an swh-id (swh:dir for a directory, swh:rev for
-        a revision, swh:rel for a release, etc.). see issue 
-        [[https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-entry/issues/5][#5]].
+        a revision, swh:rel for a release, etc.). See issue [[https://gitlab.inria.fr/gt-sw-citation/bibtex-sw-entry/issues/5][#5]].
     - version :: field (literal). The revision number of a piece of software, 
         a manual, etc.
 
-
-
 ** Reviewed proposition for a software deposit on HAL
 
 This is the most recent proposition, taking into account most fields above.