Skip to content

Commit

Permalink
addresses #205 (abbreviations expanded or linked, some more info added)
Browse files Browse the repository at this point in the history
  • Loading branch information
@bansp
bansp committed Apr 14, 2023
1 parent 95cd5e1 commit 4d3032d
Showing 1 changed file with 15 additions and 11 deletions.
26 changes: 15 additions & 11 deletions SIS/clarin/views/about.xq
View file
Original file line number Diff line number Diff line change
Expand Up @@ -25,8 +25,11 @@ import module namespace app = "http://clarin.ids-mannheim.de/standards/app" at "


<div id="about">
<p>This service has been created in 2012 and has been maintained since then at <a href="https://www.ids-mannheim.de/">IDS Mannheim</a>
as part of the Institute's activity as a <a href="https://clarin.eu/">CLARIN</a> B-Centre.</p>
<p>This service (more precisely, its <a href="{app:link("views/list-specs.xq?sortBy=name&amp;page=1")}">"Standards and Specifications" section</a>) was created in 2012
and has been maintained since then at <a href="https://www.ids-mannheim.de/">IDS Mannheim</a>
as part of the Institute's activity as a <a href="https://clarin.eu/">CLARIN</a> B-Centre. Around 2020, the system was refreshed and
extended with, among others, the section <a href="{app:link("views/recommended-formats-with-search.xq")}">"Format Recommendations"</a>.
Much of its history can be seen in the <a href="https://github.com/clarin-eric/standards">versioning system</a> hosted at GitHub.</p>
</div>
<div id="faq">
Expand All @@ -35,20 +38,22 @@ import module namespace app = "http://clarin.ids-mannheim.de/standards/app" at "
<li><h3>The data about my centre do not seem entirely correct. Where did you take these recommendations from?</h3>
<p>We bootstrapped the system with data coming from those centres that made that information available on their
homepages, as early as 2020 (and thereabouts). Note that the information had to be interpreted by us, at least
with respect to the functions of data used by the SIS
with respect to the <a href="{app:link("views/list-domains.xq")}">functions of data</a>
and often with respect to the level of recommendation (recommended vs. acceptable vs. discouraged). That initial
state of information is only meant as 'seed' for further work by the centre itself. The need for that work has been
re-iterated in the committee presentations at CACs, at NCF meetings, and often directly in conversations with
re-iterated in the committee presentations at the yearly CLARIN conferences, at NCF (National Coordinators' Forum) meetings,
and often directly in conversations with
members of centres. We will gladly deliver a zoom presentation to your centre -- please contact us about that.</p>
<p>In the meantime, we have tried to make the system as frustration-free when it comes to updating or entering recommendations
by the individual centres, as possible. Please have a look at the <a href="https://github.com/clarin-eric/standards/wiki">documentation</a>
and contact us (preferably via <a href="https://github.com/clarin-eric/standards/issues">GitHub issues</a>, so
that you can see how we respond).</p>
that you can see how we react and so that others can see that the issue is being worked on).</p>
</li>
<li><h3>Why put work into the SIS if we can have our own page, structured and styled as we please?</h3>
<p>The "as we please" bit would mean resigning from all the goodies that can be extracted out of data aggregation across CLARIN
(and, in the future, across comparable research infrastructures). The idea of the SIS is not only to make it possible to fulfil
the CTS requirements in a relatively painless manner, but also to visualize the aggregated data, and also to return the centre's
the <a href="https://www.coretrustseal.org/">CTS</a> requirements in a relatively painless manner, but also to visualize the
aggregated data, and also to return the centre's
data back to it, thanks to the <a href="{app:link("views/api.xq")}">API point</a> that we make available. "Soon" (hopefully
after the summer of 2023 at the latest), we will provide examples of how a centre can make use of its data that have been
input into the SIS in order to display them on the centre's own pages.</p>
Expand All @@ -61,10 +66,9 @@ import module namespace app = "http://clarin.ids-mannheim.de/standards/app" at "
<p>If you have any question or feedback about the content of this website, please consider using <a href="https://github.com/clarin-eric/standards/issues">GitHub issues</a>,
so that you can see how the matter is processed and what decisions are made (and often why). Link to pre-filled
templates of GitHub issues are also placed at various crucial spots in the SIS.</p>
<p>If issues don't suffice for some reason, contact us directly at the addresses below, but please be aware
that that often extends the path (because then,
most often, we need to re-post your issue ourselves, and that might take a while, and until then, the process is non-transparent),
and consequently the time to handle your feedback.</p>
<p>If issues do not suffice for some reason, contact us directly at the addresses below, but please be aware
that that often extends the path (because then, most often, we need to re-post your issue ourselves, and that might take a while, and until then,
the process is non-transparent), and consequently the time to handle your feedback.</p>

<p><b>Eliza Margaretha (main developer) </b><br />
<img src="{app:resource("margaretha.png","img")}"/><br />
Expand All @@ -82,7 +86,7 @@ import module namespace app = "http://clarin.ids-mannheim.de/standards/app" at "
<div id="tech">
<h2>Technicalities</h2>
<p>The SIS is an open-source project hosted at <a href="https://github.com/clarin-eric/standards">GitHub</a>, built using mainly XQuery (1-3.1) and XML.
It is running atop of <a href="https://exist-db.org/exist/apps/homepage/index.html">eXist-db 6.2.0</a>.</p>
It is running atop <a href="https://exist-db.org/exist/apps/homepage/index.html">eXist-db 6.2.0</a>.</p>
</div>

</div>
Expand Down

0 comments on commit 4d3032d

Please sign in to comment.