Jump to content

Help:Introduction: Difference between revisions

From RiskiPedia
No edit summary
Tweaked wording.
 
(15 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Contributing to RiskiPedia==
==Contributing to RiskiPedia==


Creating a new RiskiPedia article is only a little bit harder than creating a WikiPedia article.  
Creating a new RiskiPedia article is only a little bit harder than creating a WikiPedia article.


The easiest way to create RiskiPedia pages is to ask an AI to do most of the "grunt work". Copy and paste the prompt from [[Help:AIPrompt]] to start. '''Fact-check the results! Read the references that the AI comes up with, and make sure data matches the references.''' It is also helpful to ask another AI to check the work-- give it the [[Help:AIPrompt]] text for context, and then give it the URL of the page to check with the parameter "?action=raw" appended (which will give it the raw wikitext to read) and ask it to check references and make sure the page follows RiskiPedia best practices. AI output can be jargon-filled and stiff; ask it to make text user-friendly, jargon-free, and targeted at an intelligent 8th grader.
===Using an AI===


The second easiest way to create a new page is to find a page that is similiar to the one you want to create and copy it. Most RiskiPedia pages are split into two parts-- the main page, and a subpage containing data and calculations related to the risk (e.g. "MyRisk" and "MyRisk/Data"). If you are copying a page to start, be sure to copy both.
The easiest way to create RiskiPedia pages is to ask an AI to do most of the "grunt work". Follow the instructions on the [[Help:AIPrompt|AI prompt page]] to (hopefully!) have a productive conversation with the chatbot.
 
===Copy an existing page===
 
The second easiest way to create a new page is to find a page that is similiar to the one you want to create and [[Help:Copying_Pages|copy]] it. Most RiskiPedia pages are split into two parts-- the main page, and a subpage containing data and calculations related to the risk (e.g. "MyRisk" and "MyRisk/Data"). If you are copying a page to start, be sure to copy both.
 
===Creating a page "from scratch"===


If you want to create a page from scratch:
If you want to create a page from scratch:
Line 11: Line 17:
1. Find a study or studies or data about some risk that you're interested in. For example, maybe you're interested in the risks of skydiving, BASE jumping, and other parachuting activities-- use Google Scholar and find the best research with data on the risks.
1. Find a study or studies or data about some risk that you're interested in. For example, maybe you're interested in the risks of skydiving, BASE jumping, and other parachuting activities-- use Google Scholar and find the best research with data on the risks.


2. Insert the relevant data from the research into a RiskiPedia page. If the article about the risk will be called "Parachuting", create a page called "Parachuting/Data".  How? Just search for Parachuting/Data in the RiskiPedia page search box (at the top of the screen), and then poke the "Create the page Parachuting/Data" link that appears in the page-not-found result. Data goes inside <datatable2> tags. Include references to the studies somewhere in the Data page (or in the data table), and add any relevant comments about the data right on the Data page. For example, the table of risks for skydiving and BASE jumping might be defined as:
2. Insert the relevant data from the research into a RiskiPedia page. If the article about the risk will be called "Parachuting", create a page called "Parachuting/Data".  How? Just search for Parachuting/Data in the RiskiPedia page search box (at the top of the screen), and then poke the "Create the page Parachuting/Data" link that appears in the page-not-found result. Data goes inside <riskdata> tags. Include references to the studies somewhere in the Data page (or in the data table), and add any relevant comments about the data right on the Data page. For example, the table of risks for skydiving and BASE jumping might be defined as:
<pre>
<pre>
<nowiki><datatable2 table="skydiving" columns="variation|mean_fatality_rate|mean_injury_rate|reference">
<nowiki><riskdata table="skydiving" columns="variation|mean_fatality_rate|mean_injury_rate|reference">
Skydiving|0.000011|0.00044|[https://pmc.ncbi.nlm.nih.gov/articles/PMC9859333/]
Skydiving|0.000011|0.00044|[https://pmc.ncbi.nlm.nih.gov/articles/PMC9859333/]
BASE jumping|0.0004|0.004|[https://pubmed.ncbi.nlm.nih.gov/17495709/]
BASE jumping|0.0004|0.004|[https://pubmed.ncbi.nlm.nih.gov/17495709/]
</datatable2></nowiki>
</riskdata></nowiki>
</pre>
</pre>


Your favorite AI chatbot is likely very good at re-formatting the data for you-- just give it the data and ask it to produce a [https://www.mediawiki.org/wiki/Help:Tables MediaWiki-formatted table] with the description of each row as the first column.
Your favorite AI chatbot is likely very good at re-formatting the data for you-- just give it the data and ask it to produce a [[Help:RiskData|RiskData-formatted table]] with the description of each row in the first column. Each row should be on a new line, with values separated by pipe "|" characters.


Whenever possible, copy data verbatim from the original source(s) so it is as easy as possible for other people to confirm that the data is accurate. Data conversions or calculations should happen in RiskModel calculations.
Whenever possible, copy data verbatim from the original source(s) so it is as easy as possible for other people to confirm that the data is accurate. Data conversions or calculations should happen in RiskModel calculations.
Line 25: Line 31:
3. Insert one or more "RiskModel" using the &lt;RiskModel&gt; tag into the /Data page. RiskModels define how to combine the various risk factors (as described in the data tables) to come up with an overall risk. They also define how to display the risk. The simplest RiskModel might just look up a single value in a single data table:
3. Insert one or more "RiskModel" using the &lt;RiskModel&gt; tag into the /Data page. RiskModels define how to combine the various risk factors (as described in the data tables) to come up with an overall risk. They also define how to display the risk. The simplest RiskModel might just look up a single value in a single data table:
<pre>
<pre>
<nowiki><RiskModel name="fatality_risk_per_jump" calculation="mean_fatality_rate">Your chances of dying, per jump, are {{One_In_X|{result}}}</RiskModel>
<nowiki><RiskModel name="fatality_risk_per_jump">Your chances of dying, per jump, are {{One_In_X|{mean_fatality_rate} }}</RiskModel>
<RiskModel name="injury_risk_per_jump" calculation="mean_injury_rate">Your chances of being seriously injured, per jump, are {{One_In_X|{result}}} in 1,000</RiskModel></nowiki>
<RiskModel name="injury_risk_per_jump">Your chances of being seriously injured, per jump, are {{One_In_X|{mean_injury_rate} }}</RiskModel></nowiki>
</pre>
</pre>


Many risks will have multiple risk factors; calculation can be an arbitrary expression with as many risk factors as you need, combined using arithmetic.
Many risks will have multiple risk factors; calculation can be an arbitrary expression with as many risk factors as you need, combined using arithmetic.


The One_In_X template takes a not-very-understandable floating point risk (like 0.0000152543) and converts it into a more human-friendly form, like "13 in a million".
The One_In_X template takes a not-very-understandable floating point risk (like 0.001052543) and converts it into a more human-friendly form, like "1 in a 1,000".


4. Now you can create the page visitors interested in the risk will see. Create the parent page (e.g. "Parachuting"), again by searching for it and poking the Create the page link. Put text about the risk along with interactive UI elements that let the user select or type in the risk factors that the RiskModel uses to calculate risk. If the risk factor comes from a data table, use a &lt;DropDown&gt;. Give the DropDown the name of the table on the /Data page and it will let the visitor choose one of the rows in the table. For example:
4. Now you can create the page visitors interested in the risk will see. Create the parent page (e.g. "Parachuting"), again by searching for it and poking the Create the page link. Put text about the risk along with interactive UI elements that let the user select or type in the risk factors that the RiskModel uses to calculate risk. If the risk factor comes from a data table, use a &lt;DropDown&gt;. Give the DropDown the name of the table on the /Data page and it will let the visitor choose one of the rows in the table. For example:
Line 40: Line 46:
The final piece that puts everything together is the &lt;RiskDisplay&gt; element. Put one or more of them on the page where the "Your chances are..." text should appear, and once the visitor has specified all of the relevant risk factors the text will appear. RiskDisplay has a model attribute that refers to a RiskModel on the /Data page. For example:
The final piece that puts everything together is the &lt;RiskDisplay&gt; element. Put one or more of them on the page where the "Your chances are..." text should appear, and once the visitor has specified all of the relevant risk factors the text will appear. RiskDisplay has a model attribute that refers to a RiskModel on the /Data page. For example:
<pre>
<pre>
<nowiki><RiskDisplay model="fatality_risk_per_jump"></RiskDisplay>
<nowiki><RiskDisplay model="fatality_risk_per_jump" />
<RiskDisplay model="injury_risk_per_jump"></RiskDisplay></nowiki>
<RiskDisplay model="injury_risk_per_jump" /></nowiki></pre>
</pre>


==Working example==
==Working example==
Line 48: Line 53:
Here's the data:
Here's the data:


<datatable2 table="skydiving" columns="variation|mean_fatality_rate|mean_injury_rate|reference">
<riskdata table="skydiving" columns="variation|mean_fatality_rate|mean_injury_rate|reference">
Skydiving|0.000011|0.00044|[https://pmc.ncbi.nlm.nih.gov/articles/PMC9859333/]
Skydiving|0.000011|0.00044|[https://pmc.ncbi.nlm.nih.gov/articles/PMC9859333/]
BASE jumping|0.0004|0.004|[https://pubmed.ncbi.nlm.nih.gov/17495709/]
BASE jumping|0.0004|0.004|[https://pubmed.ncbi.nlm.nih.gov/17495709/]
</datatable2>
</riskdata>


... and the RiskModel:
... and the RiskModels:


<RiskModel name="fatality_risk_per_jump" calculation="mean_fatality_rate">Your chances of dying, per jump, are about {{One_In_X|{result}}}</RiskModel>
<RiskModel name="fatality_risk_per_jump">Your chances of dying, per jump, are {{One_In_X|{mean_fatality_rate} }}</RiskModel>
<RiskModel name="injury_risk_per_jump" calculation="mean_injury_rate">Your chances of being seriously injured, per jump, are about {{One_In_X|{result}}}</RiskModel>
<RiskModel name="injury_risk_per_jump">Your chances of being seriously injured, per jump, are {{One_In_X|{mean_injury_rate} }}</RiskModel>


... and this is what a visitor would see:
... and this is what a visitor would see:


<DropDown title="What kind of jump?" table=skydiving></DropDown>
<DropDown title="What kind of jump?" table=skydiving />
 
<RiskDisplay model="fatality_risk_per_jump" />
 
<RiskDisplay model="injury_risk_per_jump" />


<RiskDisplay model="fatality_risk_per_jump"></RiskDisplay>
==Do More==


<RiskDisplay model="injury_risk_per_jump"></RiskDisplay>
You can combine the RiskiPedia tags with all of the powerful MediaWiki tags and extensions to create very interesting, interactive pages. Study existing pages (like [[Driving]] or [[Chances of Getting Pregnant After Sex]]) for examples, and don't be afraid to experiment.


==See also==
==See also==


* [[Help:DataTable2|DataTable2 help]]
* [[Help:RiskData|RiskData help]]
* [[Help:RiskModel|RiskModel help]]
* [[Help:RiskModel|RiskModel help]]
* [[Help:RiskDisplay|RiskDisplay help]]
* [[Help:RiskDisplay|RiskDisplay help]]
* [[Help:DropDown|DropDown help]]
* [[Help:DropDown|DropDown help]]
* [[Help:RiskParameter|RiskParameter help]]
* [[Help:RiskParameter|RiskParameter help]]

Latest revision as of 06:17, 18 September 2025

Contributing to RiskiPedia

Creating a new RiskiPedia article is only a little bit harder than creating a WikiPedia article.

Using an AI

The easiest way to create RiskiPedia pages is to ask an AI to do most of the "grunt work". Follow the instructions on the AI prompt page to (hopefully!) have a productive conversation with the chatbot.

Copy an existing page

The second easiest way to create a new page is to find a page that is similiar to the one you want to create and copy it. Most RiskiPedia pages are split into two parts-- the main page, and a subpage containing data and calculations related to the risk (e.g. "MyRisk" and "MyRisk/Data"). If you are copying a page to start, be sure to copy both.

Creating a page "from scratch"

If you want to create a page from scratch:

1. Find a study or studies or data about some risk that you're interested in. For example, maybe you're interested in the risks of skydiving, BASE jumping, and other parachuting activities-- use Google Scholar and find the best research with data on the risks.

2. Insert the relevant data from the research into a RiskiPedia page. If the article about the risk will be called "Parachuting", create a page called "Parachuting/Data". How? Just search for Parachuting/Data in the RiskiPedia page search box (at the top of the screen), and then poke the "Create the page Parachuting/Data" link that appears in the page-not-found result. Data goes inside <riskdata> tags. Include references to the studies somewhere in the Data page (or in the data table), and add any relevant comments about the data right on the Data page. For example, the table of risks for skydiving and BASE jumping might be defined as:

<riskdata table="skydiving" columns="variation|mean_fatality_rate|mean_injury_rate|reference">
Skydiving|0.000011|0.00044|[https://pmc.ncbi.nlm.nih.gov/articles/PMC9859333/]
BASE jumping|0.0004|0.004|[https://pubmed.ncbi.nlm.nih.gov/17495709/]
</riskdata>

Your favorite AI chatbot is likely very good at re-formatting the data for you-- just give it the data and ask it to produce a RiskData-formatted table with the description of each row in the first column. Each row should be on a new line, with values separated by pipe "|" characters.

Whenever possible, copy data verbatim from the original source(s) so it is as easy as possible for other people to confirm that the data is accurate. Data conversions or calculations should happen in RiskModel calculations.

3. Insert one or more "RiskModel" using the <RiskModel> tag into the /Data page. RiskModels define how to combine the various risk factors (as described in the data tables) to come up with an overall risk. They also define how to display the risk. The simplest RiskModel might just look up a single value in a single data table:

<RiskModel name="fatality_risk_per_jump">Your chances of dying, per jump, are {{One_In_X|{mean_fatality_rate} }}</RiskModel>
<RiskModel name="injury_risk_per_jump">Your chances of being seriously injured, per jump, are {{One_In_X|{mean_injury_rate} }}</RiskModel>

Many risks will have multiple risk factors; calculation can be an arbitrary expression with as many risk factors as you need, combined using arithmetic.

The One_In_X template takes a not-very-understandable floating point risk (like 0.001052543) and converts it into a more human-friendly form, like "1 in a 1,000".

4. Now you can create the page visitors interested in the risk will see. Create the parent page (e.g. "Parachuting"), again by searching for it and poking the Create the page link. Put text about the risk along with interactive UI elements that let the user select or type in the risk factors that the RiskModel uses to calculate risk. If the risk factor comes from a data table, use a <DropDown>. Give the DropDown the name of the table on the /Data page and it will let the visitor choose one of the rows in the table. For example:

<DropDown title="What kind of jump?" table=skydiving></DropDown>

The final piece that puts everything together is the <RiskDisplay> element. Put one or more of them on the page where the "Your chances are..." text should appear, and once the visitor has specified all of the relevant risk factors the text will appear. RiskDisplay has a model attribute that refers to a RiskModel on the /Data page. For example:

<RiskDisplay model="fatality_risk_per_jump" />
<RiskDisplay model="injury_risk_per_jump" />

Working example

Here's the data:

variation mean_fatality_rate mean_injury_rate reference

Skydiving

0.000011

0.00044

[1]

BASE jumping

0.0004

0.004

[2]

... and the RiskModels:

  RiskModel: Help:Introduction:fatality_risk_per_jump
    Content: Your chances of dying, per jump, are {{One_In_X|{mean_fatality_rate} }}
  RiskModel: Help:Introduction:injury_risk_per_jump
    Content: Your chances of being seriously injured, per jump, are {{One_In_X|{mean_injury_rate} }}

... and this is what a visitor would see:

[{"variation":"Skydiving","mean_fatality_rate":"0.000011","mean_injury_rate":"0.00044","reference":"[https:\/\/pmc.ncbi.nlm.nih.gov\/articles\/PMC9859333\/]"},{"variation":"BASE jumping","mean_fatality_rate":"0.0004","mean_injury_rate":"0.004","reference":"[https:\/\/pubmed.ncbi.nlm.nih.gov\/17495709\/]"}]

Do More

You can combine the RiskiPedia tags with all of the powerful MediaWiki tags and extensions to create very interesting, interactive pages. Study existing pages (like Driving or Chances of Getting Pregnant After Sex) for examples, and don't be afraid to experiment.

See also