DataONE:New Contributor Tips - Revision history

Nic Weber: /* Other useful tips */

Nic Weber — Fri, 23 Jul 2010 18:29:29 GMT

Other useful tips

←Older revision		Revision as of 18:29, 23 July 2010
Line 25:		Line 25:
	* Can embed google spreadsheets (and docs and presentations) in OWW pages: instructions here [[Widget:Google_Spreadsheet]]		* Can embed google spreadsheets (and docs and presentations) in OWW pages: instructions here [[Widget:Google_Spreadsheet]]
	** Note I think you have to make your Google Spreadsheet Share->Publish as a webpage for it to work		** Note I think you have to make your Google Spreadsheet Share->Publish as a webpage for it to work
		+	*Some Direction for 'R' posts-- Heather had some great suggestions for posting Stat work to OWW. As a best practice, stats posts should have the following three elements: 1. A link to the corresponding dataset. 2. A link to the git or (better!) the embedded code (directions below) 3. Any graph or plot your code generates. PDF is probably easiest from R, but png or jpeg is probably much easier for exporting and manipulating for publications. Directions on how to do all three below.
		+	** It might not be necessary to embed datasets, but provide a link to an openly available copy (as noted above) You can embed google spreadsheets (and docs and presentations) in OWW pages: instructions here [[Widget:Google_Spreadsheet]]
		+	** To Embed Rplots, graphics and other images- The file first has to be in OWW, use the '[http://www.openwetware.org/wiki/Special:Upload upload file]' (another handy tool is the [http://www.openwetware.org/wiki/Special:MultipleUpload Multiple Upload File]) to import your image. Your filename will be the reference you use to embed the image. In your wikispace you can embed the image by using [[Image.MyImageName.png]]. I found that using 500px was a nice size for images in my daily notes [[Image.MyImageName.png \|500px]]
		+	**To embed any html simply use the < html> < /html> tags... For Rcode, once you upload to github (or gist) you can select the embed button, retrieve the script and throw it between some html tags (like so) : < html>< script src="http://gist.github .com/487090.js"> < /script>< /html>.
		+
	* Other wiki editing tips here [[Help]]		* Other wiki editing tips here [[Help]]
	* Add new tips here as you learn them, to help the next person :)		* Add new tips here as you learn them, to help the next person :)

Heather A Piwowar: add info about embedding google spreadsheets in OWW pages

Heather A Piwowar — Wed, 14 Jul 2010 17:45:21 GMT

add info about embedding google spreadsheets in OWW pages

←Older revision		Revision as of 17:45, 14 July 2010
Line 12:		Line 12:
	* Inserting <code><nowiki>*'''~~~~''':</nowiki></code> will preface a comment with your name and a timestamp like this		* Inserting <code><nowiki>*'''~~~~''':</nowiki></code> will preface a comment with your name and a timestamp like this
	**'''[[User:Heather A Piwowar\|Heather A Piwowar]] 00:34, 10 June 2010 (EDT)''': What a useful tip!		**'''[[User:Heather A Piwowar\|Heather A Piwowar]] 00:34, 10 June 2010 (EDT)''': What a useful tip!
		+
		+	==Other useful tips==
	* When you have large tables of data, link to publicly-viewable Google Spreadsheets and Google Fusion tables.		* When you have large tables of data, link to publicly-viewable Google Spreadsheets and Google Fusion tables.
	* For Google Spreadsheets and other interm-research projects, please include a README tab that gives context for the project and the preliminary nature of the data. In part, include a paragraph like this, ideally with a link to a relevant project page in OWW and your email address:		* For Google Spreadsheets and other interm-research projects, please include a README tab that gives context for the project and the preliminary nature of the data. In part, include a paragraph like this, ideally with a link to a relevant project page in OWW and your email address:
Line 21:		Line 23:
	WARNING: Data collection and validation are ongoing. Right now this dataset is definitely incomplete		WARNING: Data collection and validation are ongoing. Right now this dataset is definitely incomplete
	and likely contains errors.		and likely contains errors.
-		+	* Can embed google spreadsheets (and docs and presentations) in OWW pages: instructions here [[Widget:Google_Spreadsheet]]
		+	** Note I think you have to make your Google Spreadsheet Share->Publish as a webpage for it to work
	* Other wiki editing tips here [[Help]]		* Other wiki editing tips here [[Help]]
	* Add new tips here as you learn them, to help the next person :)		* Add new tips here as you learn them, to help the next person :)

Heather A Piwowar: add example language for providing context to stand-alone open prelim research artifacts

Heather A Piwowar — Tue, 13 Jul 2010 14:21:31 GMT

add example language for providing context to stand-alone open prelim research artifacts

←Older revision		Revision as of 14:21, 13 July 2010
Line 3:		Line 3:
	==New contributor?==		==New contributor?==
	* Add yourself to the [[DataONE:People]] page!		* Add yourself to the [[DataONE:People]] page!
-	* ~~'''NEW'''~~ Please put the DataONE header at the top of new pages. To do this, make the following the first line of the new page:	+	* Please put the DataONE header at the top of new pages. To do this, make the following the first line of the new page:

	<code><nowiki>{{DataONE}}</nowiki></code>		<code><nowiki>{{DataONE}}</nowiki></code>

-	* ~~'''NEW'''~~ To upload a file, click on "Upload file" on left menu, then to link to it in wiki text like this: <code><nowiki>[[Media:filename.pdf]]</nowiki></code>	+	* To upload a file, click on "Upload file" on left menu, then to link to it in wiki text like this: <code><nowiki>[[Media:filename.pdf]]</nowiki></code>
	** Remember to only upload things for which there are no copyright restrictions since this site is publicly accessible and open under [[OpenWetWare:Copyrights]]. So no article uploads unless it is Open Access freely redistributable or similar.		** Remember to only upload things for which there are no copyright restrictions since this site is publicly accessible and open under [[OpenWetWare:Copyrights]]. So no article uploads unless it is Open Access freely redistributable or similar.
	** Alternative ways to Upload: [http://openwetware.org/wiki/Special:Upload], [http://openwetware.org/wiki/Help:Hosting_courses#How_do_I_upload_my_lecture_slides.3F]		** Alternative ways to Upload: [http://openwetware.org/wiki/Special:Upload], [http://openwetware.org/wiki/Help:Hosting_courses#How_do_I_upload_my_lecture_slides.3F]
-	* ~~'''NEW'''~~ Inserting <code><nowiki>*'''~~~~''':</nowiki></code> will preface a comment with your name and a timestamp like this	+	* Inserting <code><nowiki>*'''~~~~''':</nowiki></code> will preface a comment with your name and a timestamp like this
	**'''[[User:Heather A Piwowar\|Heather A Piwowar]] 00:34, 10 June 2010 (EDT)''': What a useful tip!		**'''[[User:Heather A Piwowar\|Heather A Piwowar]] 00:34, 10 June 2010 (EDT)''': What a useful tip!
		+	* When you have large tables of data, link to publicly-viewable Google Spreadsheets and Google Fusion tables.
		+	* For Google Spreadsheets and other interm-research projects, please include a README tab that gives context for the project and the preliminary nature of the data. In part, include a paragraph like this, ideally with a link to a relevant project page in OWW and your email address:
		+	NOTE: This data is available in the spirit of Open Notebook Science as part of an ongoing research project.
		+	The data and calculations here are preliminary and may be misleading, incomplete, or incorrect.
		+	Please check the project page at http://www.openwetware.org/wiki/DataONE for more information,
		+	and contact us if you have questions or suggestions.
		+	* For data that is actively being collected and validated, go a step further and add extra context to leave no room for confusion:
		+	WARNING: Data collection and validation are ongoing. Right now this dataset is definitely incomplete
		+	and likely contains errors.
		+
	* Other wiki editing tips here [[Help]]		* Other wiki editing tips here [[Help]]
	* Add new tips here as you learn them, to help the next person :)		* Add new tips here as you learn them, to help the next person :)

Heather A Piwowar: initial content

Heather A Piwowar — Mon, 12 Jul 2010 21:15:06 GMT

initial content

New page

{{DataONE}}

==New contributor?==
* Add yourself to the [[DataONE:People]] page!
* '''NEW''' Please put the DataONE header at the top of new pages. To do this, make the following the first line of the new page:

<code><nowiki>{{DataONE}}</nowiki></code>

* '''NEW''' To upload a file, click on "Upload file" on left menu, then to link to it in wiki text like this: <code><nowiki>[[Media:filename.pdf]]</nowiki></code>
** Remember to only upload things for which there are no copyright restrictions since this site is publicly accessible and open under [[OpenWetWare:Copyrights]]. So no article uploads unless it is Open Access freely redistributable or similar.
** Alternative ways to Upload: [http://openwetware.org/wiki/Special:Upload], [http://openwetware.org/wiki/Help:Hosting_courses#How_do_I_upload_my_lecture_slides.3F]
* '''NEW''' Inserting <code><nowiki>*'''~~~~''':</nowiki></code> will preface a comment with your name and a timestamp like this
**'''[[User:Heather A Piwowar|Heather A Piwowar]] 00:34, 10 June 2010 (EDT)''': What a useful tip!
* Other wiki editing tips here [[Help]]
* Add new tips here as you learn them, to help the next person :)