Difference between revisions of "Documentation:How to use the Fixer"

Jump to navigation Jump to search
m
11 revisions imported
m (11 revisions imported)
 
(6 intermediate revisions by the same user not shown)
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]]
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 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.
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]]
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]]

Navigation menu