[GitHub] [jena-site] afs commented on a change in pull request #83: Add Citing section to site

[GitBox <gi...@apache.org>]

afs commented on a change in pull request #83:
URL: https://github.com/apache/jena-site/pull/83#discussion_r769722302



##########
File path: source/about_jena/citing.md
##########
@@ -0,0 +1,33 @@
+---
+title: Citing Jena
+---
+
+[comment]: <> (https://lists.apache.org/thread/jl8npmty96j1gkflmlpx5c0kcfdjr3f6)
+
+The name of the project is “Apache Jena”. That should appear as the first
+use in a paper and in a reference. After that "Jena" can be used.
+It is also a [trademark](https://www.apache.org/foundation/marks/#books)
+of the Apache Software Foundation. This is also the industry practice.
+
+The reference should indicate the website <https://jena.apache.org/>
+(`https` is preferable). If relevant to reproducibility, or discussing
+performance, the release version number **MUST** also be included. The date

Review comment:
       IMO: A bit shouty. "must" is enough.

##########
File path: layouts/_default/baseof.html
##########
@@ -120,6 +120,7 @@
                         <li class="divider"></li>
                         <li class="dropdown-header">Project</li>
                         <li><a href="/about_jena/about.html">About Jena</a></li>
+                        <li><a href="/about_jena/citing.html">Citing</a></li>

Review comment:
       (It isn't showing in the staged build for me - should PRs from other repos show up there?)
   
   I doubt people that don't search hard enough will look in a dropdown. Or look at the site :-) Best we can hope for is Google search for "jena citation".
   
   Adding to baseof.html adds it to every page.
   
   Maybe one the "about" page is enough?




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: dev-unsubscribe@jena.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org