Documentation:How to use the Fixer - Revision history

Karen: 11 revisions imported

2022-03-08T08:25:46Z

11 revisions imported

← Older revision	Revision as of 08:25, 8 March 2022
(No difference)

Karen at 09:25, 23 July 2021

2021-07-23T09:25:07Z

← Older revision		Revision as of 09:25, 23 July 2021
Line 1:		Line 1:
	Let me tell you about the most insidious mistake you are going to make when creating layers. It usually happens when you work ~~with~~ a layer that contains a large number of instantaneous events. Take for example the layer containing events of the French Revolution. I’ve made (and then fixed) a couple of such mistakes when creating it.		Let me tell you about the most insidious mistake you are going to make when creating layers. It usually happens when you work on a layer that contains a large number of instantaneous events. Take for example the layer containing events of the French Revolution. I’ve made (and then fixed) a couple of such mistakes when creating it.

	[[File:FrenchRevolution.png]]		[[File:FrenchRevolution.png]]

Karen: /* How to fix it */

2021-06-21T18:01:17Z

How to fix it

← Older revision		Revision as of 18:01, 21 June 2021
Line 50:		Line 50:
	If you’ve found this mistake while parsing the data, you can just fix the markup in the Parser and parse the data anew. But what if you’ve found the mistake much later and you don’t have the source text any more?		If you’ve found this mistake while parsing the data, you can just fix the markup in the Parser and parse the data anew. But what if you’ve found the mistake much later and you don’t have the source text any more?

	Don’t try to fix it manually. If there are more than few incorrect dates, it will be very tedious and error prone to fix them manually. I have created a special program that helps you fix this mistake. I call it the Fixer. And you can find a link to it in the bottom right corner of the Editor.		Don’t try to fix it manually. If there are more than a few incorrect dates, it will be very tedious and error prone to fix them manually. I have created a special program that helps you fix this mistake. I call it the Fixer. And you can find a link to it in the bottom right corner of the Editor.

	[[File:ParserButton.png\|600px]]		[[File:ParserButton.png\|600px]]

Karen: /* How to detect this mistake */

2021-06-21T18:00:25Z

How to detect this mistake

← Older revision		Revision as of 18:00, 21 June 2021
Line 43:		Line 43:

	==How to detect this mistake==		==How to detect this mistake==
	There is only one surefire method that I know of. When you are done creating the instructions for the layer, you put them into the Editor and make the events show up on the Timeline. Then you open the source page, from which you’ve taken the information in the first place, and put it next to the Timeline. And then you just go through the list of events and compare each and every event in the source to the corresponding event on the Timeline, one by one. However long it takes, you have to do it. Otherwise you don’t know if what you are uploading to the server is correct information or ~~a pile of~~ garbage.		There is only one surefire method that I know of. When you are done creating the instructions for the layer, you put them into the Editor and make the events show up on the Timeline. Then you open the source page, from which you’ve taken the information in the first place, and put it next to the Timeline. And then you just go through the list of events and compare each and every event in the source to the corresponding event on the Timeline, one by one. However long it takes, you have to do it. Otherwise you don’t know if what you are uploading to the server is correct information or just some garbage.

	This is very important. I think in the future we may have some peer review process in place. For example, there may be a rule that a layer can’t leave the Sandbox until, let’s say, 2 or 3 admins have checked that the dates in it are correct.		This is very important. I think in the future we may have some peer review process in place. For example, there may be a rule that a layer can’t leave the Sandbox until, let’s say, 2 or 3 admins have checked that the dates in it are correct.

Karen: Protected "Documentation:How to use the Fixer" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

2021-06-18T13:46:50Z

Protected "Documentation:How to use the Fixer" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

← Older revision	Revision as of 13:46, 18 June 2021
(No difference)

Karen: /* How to fix it */

2021-06-17T20:01:17Z

How to fix it

← Older revision		Revision as of 20:01, 17 June 2021
Line 63:		Line 63:
	[[File:FixerStep2.png]]		[[File:FixerStep2.png]]

	Step 3: Find the dates that are incorrect and need to be moved. To select a range of dates select the first one with a mouse, then, holding down the Shift key, select the last ~~date~~.		Step 3: Find the dates that are incorrect and need to be moved. To select a range of dates select the first one with a mouse, then, holding down the Shift key, select the last one.

	[[File:FixerStep3.png]]		[[File:FixerStep3.png]]

Karen: /* How to detect this mistake */

2021-06-17T19:59:18Z

How to detect this mistake

← Older revision		Revision as of 19:59, 17 June 2021
Line 43:		Line 43:

	==How to detect this mistake==		==How to detect this mistake==
	There is only one surefire method that I know of. When ~~you’ve~~ done creating the instructions for the layer, you put them into the Editor and make the events show up on the Timeline. Then you open the source page, from which you’ve taken the information in the first place, and put it next to the Timeline. And then you just go through the list of events and compare each and every event in the source to the corresponding event on the Timeline, one by one. However long it takes, you have to do it. Otherwise you don’t know if what you are uploading to the server is correct information or a pile of garbage.		There is only one surefire method that I know of. When you are done creating the instructions for the layer, you put them into the Editor and make the events show up on the Timeline. Then you open the source page, from which you’ve taken the information in the first place, and put it next to the Timeline. And then you just go through the list of events and compare each and every event in the source to the corresponding event on the Timeline, one by one. However long it takes, you have to do it. Otherwise you don’t know if what you are uploading to the server is correct information or a pile of garbage.

	This is very important. I think in the future we may have some peer review process in place. For example, there may be a rule that a layer can’t leave the Sandbox until, let’s say, 2 or 3 admins have checked that the dates in it are correct.		This is very important. I think in the future we may have some peer review process in place. For example, there may be a rule that a layer can’t leave the Sandbox until, let’s say, 2 or 3 admins have checked that the dates in it are correct.

Karen: /* How to fix it */

2021-06-17T19:55:19Z

How to fix it

← Older revision		Revision as of 19:55, 17 June 2021
Line 67:		Line 67:
	[[File:FixerStep3.png]]		[[File:FixerStep3.png]]

	Step 4: Use up or down arrow key on the keyboard to move the stack of dates up or down. In our example, we need to move ~~them~~ up.		Step 4: Use up or down arrow key on the keyboard to move the stack of dates up or down. In our example, we need to move it up.

	[[File:FixerStep4.png]]		[[File:FixerStep4.png]]

Karen: /* How to fix it */

2021-06-17T19:54:33Z

How to fix it

← Older revision		Revision as of 19:54, 17 June 2021
Line 63:		Line 63:
	[[File:FixerStep2.png]]		[[File:FixerStep2.png]]

	Step 3: Find the dates that are incorrect. To select a range of dates select the first one with a mouse, then, holding down the Shift key, select the last date.		Step 3: Find the dates that are incorrect and need to be moved. To select a range of dates select the first one with a mouse, then, holding down the Shift key, select the last date.

	[[File:FixerStep3.png]]		[[File:FixerStep3.png]]

Karen: /* This mistake is totally unacceptable */

2021-06-17T19:51:50Z

This mistake is totally unacceptable

← Older revision		Revision as of 19:51, 17 June 2021
Line 39:		Line 39:

	==This mistake is totally unacceptable==		==This mistake is totally unacceptable==
	We want people to trust the data on the Timeline. ‘Trust but verify’ is a good principle to follow in many circumstances. And we have sources specified for each layer. So, if users want to verify the data they can certainly do so. However, if the users start finding events with ~~wrong~~ dates in multiple places on the Timeline, eventually they will feel like they can’t trust any data on this website unless they verify each and every event themselves. This will make the Timeline virtually unusable.		We want people to trust the data on the Timeline. ‘Trust but verify’ is a good principle to follow in many circumstances. And we have sources specified for each layer. So, if users want to verify the data they can certainly do so. However, if the users start finding events with incorrect dates in multiple places on the Timeline, eventually they will feel like they can’t trust any data on this website unless they verify each and every event themselves. This will make the Timeline virtually unusable.
	We don’t want that. So you must do everything humanly possible to make sure you haven’t made this mistake before uploading data to the server.		We don’t want that. So you must do everything humanly possible to make sure you haven’t made this mistake before uploading data to the server.