Snicdocs - Revision history

Joel Hedlund (NSC) at 11:39, 18 September 2013

2013-09-18T11:39:16Z

Torben Rasmussen (NSC) at 07:27, 17 April 2013

2013-04-17T07:27:29Z

Torben Rasmussen (NSC) at 07:26, 17 April 2013

2013-04-17T07:26:50Z

Torben Rasmussen (NSC): /* Development */

2012-06-04T14:32:02Z

‎Development

Joel Hedlund (NSC): /* Features */

2012-03-13T20:21:10Z

‎Features

Joel Hedlund (NSC): /* Members */

2012-03-13T08:56:35Z

‎Members

Joel Hedlund (NSC) at 08:56, 13 March 2012

2012-03-13T08:56:11Z

Joel Hedlund (NSC) at 12:38, 12 March 2012

2012-03-12T12:38:42Z

Joel Hedlund (NSC) at 12:36, 12 March 2012

2012-03-12T12:36:47Z

Joel Hedlund (NSC) at 10:59, 12 March 2012

2012-03-12T10:59:07Z

← Older revision		Revision as of 11:39, 18 September 2013
Line 69:		Line 69:
	=== Roles ===		=== Roles ===
	[[User:Joel Hedlund (NSC)]] is the lead developer of Snicdocs.		[[User:Joel Hedlund (NSC)]] is the lead developer of Snicdocs.
		+
		+	== Changelog ==
		+	; 2013-09-18
		+	: Add support for denoting whether a person is to be considered on active duty. People not on active duty should not appear in dynamically generated lists, e.g. for expertise or staff.

@@ Line 1: / Line 1: @@
 {{project info
 |description=A knowledgebase of user oriented information in Swedish academic high performance computing.
-<!--|financing=SNIC-->
+|financing=SNIC
 |active=yes
 |start date=2011-05-20

@@ Line 1: / Line 1: @@
 {{project info
 |description=A knowledgebase of user oriented information in Swedish academic high performance computing.
-|financing=SNIC
+<!--|financing=SNIC-->
 |active=yes
 |start date=2011-05-20

← Older revision		Revision as of 14:32, 4 June 2012
Line 56:		Line 56:
	Snicdocs is hosted by [[NSC]] and developed mostly by [[User:Joel Hedlund (NSC)]].		Snicdocs is hosted by [[NSC]] and developed mostly by [[User:Joel Hedlund (NSC)]].

		+	=== Ideas ===
		+
		+	* Create a query listing all registered expertise
		+	** Look into using the Arrays extension or the Semantic Bundle of extensions for this purpose

	== Members ==		== Members ==

@@ Line 23: / Line 23: @@
 == Features ==
 Snicdocs has cross-indexed and searchable information on a variety of topics, and presents it both in natural language and in dynamically generated, sortable views. Some features include:
 * [[Resources|Resource information]]
 ** Location and capabilities of academic resources for computation in Sweden.
@@ Line 43: / Line 47: @@
 * [[Help:Management|Managerial views]] for SNIC
 ** Who's salary is financed by SNIC?
 ** What SNIC projects are
 == Development ==

@@ Line 59: / Line 59: @@
 |?field
 }}
 [[User:Joel Hedlund (NSC)]] is the lead developer of Snicdocs.

@@ Line 20: / Line 20: @@
 The contents of this wiki is kept current by application and systems experts in the Swedish research and HPC communities, and members of the general public can contribute by asking questions and posting comments on the "Discussion" pages, which accompany every normal wiki page (see tab on top of page). Snicdocs uses browser client certificates for authorization of editors.
 == Development ==
@@ Line 35: / Line 59: @@
 |?field
 }}

@@ Line 15: / Line 15: @@
 * Who are the people I can get help from?
-This wiki will also be used to advertise projects and activities within Swedish academic HPC.
+Snicdocs will also be used to advertise projects, services and activities within Swedish academic HPC.
 The idea is that Snicdocs should contain information applicable across all centers in Sweden, and link to original source for documentation that is valid worldwide. And conversely, link to local pages at specific centres for information on local implementations that are is different enough to warrant special description. Consequentially, it is a goal to keep Snicdocs and local pages as empty as possible, and instead strive to remove special cases, harmonize solutions, and to work to improve upstream documentation so that everything works as expected worldwide. An added benefit is that a wiki with less words and special cases is both easier to read and to keep up to date.

@@ Line 7: / Line 7: @@
 }}
-Snicdocs is the working name for the wiki you are now reading. Its purpose is to become ''the'' place to put user oriented information in Swedish academic high performance computing. Some examples include:
+Snicdocs is the working name for the wiki you are now reading. Its purpose is to become ''the'' place for user oriented information in Swedish academic high performance computing. Some examples include:
 * What computing resources are available.
@@ Line 15: / Line 15: @@
 * Who are the people I can get help from?
-The idea is for Snicdocs to contain information applicable across all centers in Sweden, and to link to the original source for information valid worldwide. And conversely, to link to local pages at specific centres for those cases where a local implementation is different enough to warrant special description. Consequentially, it is a goal to keep Snicdocs and local pages as empty as possible, and instead strive to remove special cases, harmonize solutions, and to work to improve upstream documentation so that everything works as expected worldwide. An added benefit is that a wiki with less words and special cases is both easier to read and to keep up to date.
+This wiki will also be used to advertise projects and activities within Swedish academic HPC.
-The contents of this wiki is kept current by application and systems experts in the Swedish research and HPC communities, and members of the general public can contribute by asking questions and posting comments on the "Discussion" pages, which accompany every normal wiki page (see tab on top of page). This site uses browser installed client certificates for authorization of editors.
+The idea is that Snicdocs should contain information applicable across all centers in Sweden, and link to original source for documentation that is valid worldwide. And conversely, link to local pages at specific centres for information on local implementations that are is different enough to warrant special description. Consequentially, it is a goal to keep Snicdocs and local pages as empty as possible, and instead strive to remove special cases, harmonize solutions, and to work to improve upstream documentation so that everything works as expected worldwide. An added benefit is that a wiki with less words and special cases is both easier to read and to keep up to date.
 == Development ==
-Since the content contributors to Snicdocs are distributed throughout Sweden and opportunities for face-to-face meetings are infrequent, it is necessary for a project like this to have well-defined scope and structure, and be straightforward to keep current and consistent. Therefore, Snicdocs uses the widely known [http://mediawiki.org mediawiki] software (used also by for example [http://wikipedia.org Wikipedia]) with [http://semantic-mediawiki.org semantic mediawiki] added for dynamic generation of content and for minimizing duplication of data.
+Since the Snicdocs content contributors are distributed throughout Sweden, and opportunities for face-to-face meetings are infrequent, it is necessary for this system to be straightforward to keep current and consistent. Therefore, Snicdocs uses the widely known [http://mediawiki.org mediawiki] software (used also by for example [http://wikipedia.org Wikipedia]) with [http://semantic-mediawiki.org semantic mediawiki] added for dynamic generation of content and for minimizing duplication of data. On top of this it requires well-defined scope and structure to ensure searchability and readability.
-Most of the development of Snicdocs has gone into ensuring that best way to enter information into the wiki also is the easiest way, so that new data will be added in a readable, consistent, homogeneous and searchable manner. In practical terms this means determining useful category hierarchies for relevant topics, so that relevant pages are easily found, and determining minimal useful sets of required information on pages within these topics, so that only the information that is absolutely required actually ''is'' required, so that contributors can spend their time adding content rather than fulfilling arbitrary and sometimes inapplicable content restrictions. Another major part has been writing reusable page templates and example pages for these topics, and to present sufficiently clear and concise editing guidelines so that our disparate and distributed editor community can still provide a homogeneous browsing experience for the users.
+Most of the development of Snicdocs has gone into ensuring that best way to enter information into the wiki also is the easiest way, so that new data will be added in a readable, consistent, homogeneous and searchable manner. In practical terms this means determining useful category hierarchies for relevant topics, so that relevant pages can be found easily, and determining minimal useful sets of required information on pages within these topics, so that contributors can spend their time adding content rather than fulfilling arbitrary and sometimes inapplicable restrictions. Another major part has been writing reusable page templates and example pages for these topics, and to present sufficiently clear and concise editing guidelines so that our disparate and distributed editor community can still provide a homogeneous browsing experience for the users.
 Snicdocs is hosted by [[NSC]] and developed mostly by [[User:Joel Hedlund (NSC)]].