Contributing to the NJDA Site

From National Justice Data Architecture
Jump to: navigation, search

The National Data Architecture wiki is a collaboratively edited encyclopedia to which you can contribute. Before contributing, please read our Policies & Guidelines. The tutorial will help you become a Data Architecture contributor and provide guidance about the style and content of articles.


Policies & Guidelines

User Accounts

Copyrights

Content

Article titles The ideal title for a contribution is specific, easy to find, precise, concise, and consistent with other titles.

Image use policy Avoid uploading non-free images; fully describe images' sources and copyright details on their description pages, and try to make images as useful and reusable as possible.

Neutral point of view All contributions, including articles, links, and images must be neutral and without bias.

No original research Articles may not contain any unpublished theories, data, statements, concepts, arguments, or ideas; or any new interpretation, analysis, or synthesis of published data, statements, concepts, arguments, or ideas that.

Verifiability Contributions should cite sources whenever possible. While we cannot check the accuracy of cited sources, we can check whether they have been published by a reputable publication and whether independent sources have supported them on review. Any unsourced material may be removed.

Basic Editing Tutorial

This is a basic tutorial, not an extensive manual. For more details, MediaWiki HelpLinks are provided for further editing and formatting information. A Contributor Sandbox page is available to experiment and practice.

With the exception of a few protected pages, every page has an File:Tutorial Edit Bar.png tab which lets you edit the page you are looking at. This feature allows you to make corrections and add facts to articles. If you add information to an article, please provide references, because unreferenced facts can be removed. To practice editing, go to the sandbox and click the "Edit" tab. When you click the "Edit" tab, that will open an editing window containing the text for that page. Type in something, or make changes to the text you find there. Now, click the 'Save page' button and see what the result looks like.

There are two steps you should do if you are editing an article or other page. Click the "Edit" tab again, enter some text, and then do those two additional steps.

First, any time you edit a page, it is considered good practice to enter an explanation of your changes in the Edit summary box, which you'll find below the edit window. A short explanation is fine. For example, if you are making a spelling correction, you might just type "typo". Also, if the change you have made to a page is minor, such as correcting a spelling or grammar error, it's helpful if you check the box "This is a minor edit". (This box is only available if you have logged in.) For your sandbox edit, you probably want an edit summary such as "Testing".

Second, you should always use the 'Show preview' button. After you've entered a change in the edit box for the sandbox, click the Show preview button instead of 'Save Page'. This lets you see what the page will look like after your edit, before you actually save. This feature helps you preview formatting and catch mistakes them before publishing. Using 'Show Preview' before saving also lets you try format changes and other edits without cluttering up the page history. Do not forget to save your edits after previewing, though!

Also, at the top left of the editing window, there are aids Edit Aids Bar.pngwith hover hints for formatting, inserting external or internal links, and images.

Mediawiki HelpLinks

Mediawiki Help Table of Contents

Editing Pages

Formatting

Images

Mediawiki Ontologies Extensions

For instance one of the ontologies is named "Dublin Core" (whose namespace prefix is "dc") - its extension contains just one parser function (named "dc") that is used to validate and then set the value(s) on a page for any of the properties defined by that ontology. (Please see [Dublin Core] for official documentation regarding this ontology.)

So if you want to set the property "dc:title" for a page, then simply call Template:Dc:title. For multilingual wikis, one says Template:Dc:title; the parser function in this latter case creates a subobject named "dc:title" with properties named appropriately eg @en and @de.

You may want to create your own property that is a "dc:title" but which is to have a different name, here's all you do: 1) insert dc:title on (say) your "Property:Report name" page 2) call Template:Dc:title on a page or within your "class" template

Validation errors are stored in special property "smw:error" that can be reported using Some subquery has no valid condition.. A property value is not stored if a validation error is raised.

A base ontology named "smw" is the first to be released, implemented as described above; it contains properties and classes builtin to, or implied by, the MediaWiki and Semantic MediaWiki software -- these properties and classes form the lowest level ontology upon which ALL other classes and properties are then defined (that is, via class/subclass and property/subproperty relations).

There will be an update.php -based mechanism for loading Property and Category pages into one's wiki referenced by these ontology parser functions. It also loads a page named "Ontology: /name/" into the Concept namespace of the wiki so that users may conveniently access information about the ontology.