Category:Howtos - Revision history

Jmandel: link

2010-04-04T16:56:25Z

link

← Older revision		Revision as of 16:56, 4 April 2010
Line 1:		Line 1:
	One of the greatest dangers in any project is that people do not know how to reproduce the work already done, then the work is effectively lost. Yet reproducibility is the first requirement of science!		One of the greatest dangers in any project is that people do not know how to reproduce the work already done, then the work is effectively lost. Yet reproducibility is the first requirement of science!

	This category is for pages that describe your success and allow others to do it again. See [[Help:Howtos~~\|what should be included in howtos~~]].		This category is for pages that describe your success and allow others to do it again. See [[Help:Howtos]].

	[[Category:Contents]]		[[Category:Contents]]

Jmandel: Category:Contents

2010-04-04T16:04:21Z

Category:Contents

← Older revision		Revision as of 16:04, 4 April 2010
Line 2:		Line 2:

	This category is for pages that describe your success and allow others to do it again. See [[Help:Howtos\|what should be included in howtos]].		This category is for pages that describe your success and allow others to do it again. See [[Help:Howtos\|what should be included in howtos]].

			[[Category:Contents]]

Jmandel at 20:22, 27 January 2010

2010-01-27T20:22:06Z

← Older revision		Revision as of 20:22, 27 January 2010
Line 1:		Line 1:
	One of the greatest dangers in any project is that people do not know how to reproduce the work already done, then the work is effectively lost. Yet reproducibility is the first requirement of science!		One of the greatest dangers in any project is that people do not know how to reproduce the work already done, then the work is effectively lost. Yet reproducibility is the first requirement of science!

	This category is for pages that describe your success and allow others to do it again. See ~~the~~ [[Help:Howtos\|what should be included in howtos]] ~~for suggested style~~.		This category is for pages that describe your success and allow others to do it again. See [[Help:Howtos\|what should be included in howtos]].

Jmandel at 20:21, 27 January 2010

2010-01-27T20:21:23Z

← Older revision		Revision as of 20:21, 27 January 2010
Line 1:		Line 1:
	One of the greatest dangers in any project is that people do not know how to reproduce the work already done, then the work is effectively lost. Yet reproducibility is the first requirement of science!		One of the greatest dangers in any project is that people do not know how to reproduce the work already done, then the work is effectively lost. Yet reproducibility is the first requirement of science!

	This category is for pages that describe your success and allow others to do it again. See the [[~~What~~ should be included in howtos]] for suggested style.		This category is for pages that describe your success and allow others to do it again. See the [[Help:Howtos\|what should be included in howtos]] for suggested style.

Jmandel: rm Category:Help that's editing help only

2010-01-27T20:13:30Z

rm Category:Help that's editing help only

← Older revision		Revision as of 20:13, 27 January 2010
Line 2:		Line 2:

	This category is for pages that describe your success and allow others to do it again. See the [[What should be included in howtos]] for suggested style.		This category is for pages that describe your success and allow others to do it again. See the [[What should be included in howtos]] for suggested style.

	~~[[Category:Help]]~~

Jmandel: Category:Help

2010-01-27T20:12:34Z

Category:Help

← Older revision		Revision as of 20:12, 27 January 2010
Line 2:		Line 2:

	This category is for pages that describe your success and allow others to do it again. See the [[What should be included in howtos]] for suggested style.		This category is for pages that describe your success and allow others to do it again. See the [[What should be included in howtos]] for suggested style.

			[[Category:Help]]

Jmandel: What should be included in howtos

2010-01-17T06:12:15Z

What should be included in howtos

← Older revision		Revision as of 06:12, 17 January 2010
Line 1:		Line 1:
	One of the greatest dangers in any project is that people do not know how to reproduce the work already done, then the work is effectively lost. Yet reproducibility is the first requirement of science!		One of the greatest dangers in any project is that people do not know how to reproduce the work already done, then the work is effectively lost. Yet reproducibility is the first requirement of science!

	This category is for pages that describe your success and allow others to do it again. See the [[~~Category talk:Howtos\|talk page~~]] for suggested style.		This category is for pages that describe your success and allow others to do it again. See the [[What should be included in howtos]] for suggested style.

Jmandel: purpose

2010-01-17T05:24:05Z

purpose

← Older revision		Revision as of 05:24, 17 January 2010
Line 1:		Line 1:
	One of the greatest dangers in any project is that people do not know how to reproduce the work already done, then the work is effectively lost. Yet reproducibility is the first requirement of science!		One of the greatest dangers in any project is that people do not know how to reproduce the work already done, then the work is effectively lost. Yet reproducibility is the first requirement of science!

	This category is for pages that describe your ~~successes~~. See the [[Category talk:Howtos\|talk page]] for suggested style.		This category is for pages that describe your success and allow others to do it again. See the [[Category talk:Howtos\|talk page]] for suggested style.

Jmandel: mv reqs to talk

2010-01-17T05:23:22Z

mv reqs to talk

← Older revision		Revision as of 05:23, 17 January 2010
Line 1:		Line 1:
	One of the greatest dangers in any project is that people do not know how to reproduce the work already done, then the work is effectively lost. Yet reproducibility is the first requirement of science! ~~Please describe how to reproduce your successes here. Here are some suggestions.~~		One of the greatest dangers in any project is that people do not know how to reproduce the work already done, then the work is effectively lost. Yet reproducibility is the first requirement of science!

	* Keep it simple. It's not the complete documentation, it's just a Howto.		This category is for pages that describe your successes. See the [[Category talk:Howtos\|talk page]] for suggested style.
	* Give minimal information needed to reproduce building the code and running it on a particular problem. ~~It's OK to refer to specific README files in the source code, no need to repeat~~ the ~~info here, but it must be clear how to get to it.~~
	* Include links to the code and data repositores, and to the documentation.
	* Record versions with which it all worked, such as [[~~Wikipedia~~:~~git (software)~~\|~~git]] commit hash or [[Wikipedia:Subversion (software)\|Subversion]] tag for source codes, the date and some checksum ([[Wikipedia:Sum (Unix)\|sum~~]]~~, [[Wikipedia:MD5\|md5sum]])~~ for ~~data files, and versions of the operating system, compilers, and libraries.~~
	* Include some pictures and results.
	* Update the page as the codes and data change, but do not delete the information on past working versions.

	~~Thanks!~~

Jmandel: misc

2010-01-17T05:20:43Z

misc

← Older revision		Revision as of 05:20, 17 January 2010
Line 1:		Line 1:
	One of the greatest dangers in any project is that people do not know how to reproduce the work already done, ~~and it~~ is effectively lost. Yet reproducibility is the first requirement of science! Please:		One of the greatest dangers in any project is that people do not know how to reproduce the work already done, then the work is effectively lost. Yet reproducibility is the first requirement of science! Please describe how to reproduce your successes here. Here are some suggestions.

	* Keep it simple. It's not the complete documentation, it's just a Howto.		* Keep it simple. It's not the complete documentation, it's just a Howto.