Help:Tracking changes: Difference between revisions

From FlightGear wiki
Jump to navigation Jump to search
(More on recent changes, the watchlist and the history tab)
(→‎Your watchlist: - Redundant text)
(19 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{WIP}}
{{tip|
Giving a comprehensive and concise '''edit summary''' will help other understand the revision history.


This '''tutorial''' is mainly aimed at people new to the [[Main Page|FlightGear wiki]], but might also be useful for the more experienced users from time to time.
'''Why''' the edit was done is more useful than '''what''' was edited — a diff will show '''what''' was edited but not '''why'''.}}
{{tip|
You can help '''fighting spam''' by checking [[Special:RecentChanges|recent changes]] when you log in on the wiki.}}


The main purpose here is to explain how to use the wiki software, how it is structured, where you can learn more about it, and not less important, how to interact with the part of the FlightGear community that is directly involved with the wiki.
{{Wiki help navbar}}


== For readers new to a wiki ==
'''Tracking changes''' on the wiki is relatively easy.  One of the main characteristics of the MediaWiki software the FlightGear wiki is using is that the revision history of all pages are preserved and available to everyone.  This allows for very transparent collaboration.
{{tip|If you are very familiar with Wikipedia, you can just skim through this section or even skip it.}}


A wiki is a place for collaborationThere are many like it but this is ours.  As with most wikis they allow readers to browse through the ''articles'' and other ''pages'' making up the content of the wiki.  Pages can also be found by using ''links'', traversing ''categories'' and ''searching''.  But lets start by describing what you can see on a typical wiki page.
== Notification of edits to your discussion page ==
You will be notified if someone else edit your discussion pageThe next time you log in on the wiki or load a page you will see a notification that there are new messages on your discussion page.


=== Elements of a wiki page ===
You can also optionally change your preferences so that you will receive an email if your discussion page have been edited.
While there are two ways to view wiki pages, the ''desktop view'' and the ''mobile view'', we will go through the ''desktop'' view here as the mobile view hides many features for the sake of simplicity.  The features are described as seen with the default Vector skin.


From the top you have ''user links'' on the top right.  These are related to your account (if you have one).  On top of the content of the page there are some ''page tabs'' related to the page.  On the left is the ''sidebar'' with navigation links, links to various tools and links to other language versions of a page.  On the bottom of the contents of a page is a ''category link'' a link to a ''category page'' listing other pages in the category.
== Recent changes to the wiki ==
The page [[Special:RecentChanges]] is a list of all the recent changes on the wiki.


==== User links ====
If you want to have a feel about what is going on on the wiki you could start your wiki session by having a peek at that page.
[[File:FlightGear wiki user links.png|frame|none|The user links for a logged in user]]


If you have an account and is logged in the ''user links'' to the very top right are related to you user account:
Some of the things visible there are:


:; Your user page
* Edits to pages
:: Your user page, where you are encouraged to describe who you are and what ambitions you have on the wiki.
* Creation of new pages
:: You can also add subpages to your user page with for example drafts and other wiki projects.
* File uploads, usually images
:; Talk
* Creation of new users
:: You user discussion page, where other users may be able to take contact with you.
* Pages being protected
:: If your discussion page have been edited, you will get a notice when you load any wiki page.
* Deletion of pages or files
:; Preferences
:: Your wiki preferences, where you can adjust and customize some settings.
:; Watchlist
:: Your watchlist, which list changes on pages you have "starred" and are watching.
:; Contributions
:: A summary of your contributions and uploads to the wiki.
:; Log out
:: Through which you log out from your account.


==== Page tabs ====
As it shows all the latest changes it is often the place where one will find any spam, vandalism or other unwanted edits.
[[File:FlightGear wiki page tabs.png|frame|none|The page tabs for a logged in admin (who can additionally delete and protect pages)]]


On top of the page content there is a set of tabs:
If you are logged in, changes to pages that are on your [[#Your watchlist|watchlist]] will be highlighted in bold.


:; An article or page tab
One days changes will for example look like below:
:: For viewing the article if you are on another tab or for going directly to the page if you have been redirected.
:: The page tab also gives an indication about what kind of page you are on.
:; A discussion tab
:: With the discussion page for a wiki page or a user.


:; A read tab
[[File:FlightGear wiki recent changes.png|none|frame|Recent changes on the wiki. Only some users have rights to block users.]]
:: With the exact same function as the page tab
:; An edit or source tab
:: Which will allow you to edit a page on the wiki when logged in or see the page source if not.
:; A history tab
:: Which will show the edit history for a wiki page.
:; A star tab
:: That will add or remove a page to or from your watchlist.
:; A more tab
:: That hide some more functions, in particular a function to move pages.  Wiki admins also have a protect and a delete function.


==== Search box ====
For each row you will see
[[File:FlightGear wiki search box.png|frame|none|The search box]]
* A mark indicating for example '''N''' for new pages and '''m''' for minor changes (if the user marked that checkbox when saving his edit of the page)
* The time of the revision (in the time zone set in your preferences (see [[Special:Preferences|Preferences]] link on the top right of every page)
* A link with the title of the page to the revision of the page
* A link '''cur''' linking to a [[#Diffs|diff]] comparing the revision with the current revision
* A link '''prev''' linking to a diff comparing the revision with the previous revision
* The number of characters added or removed in the edit
* A link with the name of the user who did the edit linking to his user page
* A link '''talk''' linking to the users discussion page
* A link '''contrib''' linking to to a list of the users contributions
* A link to the article section that was edited if the user edited a specific section (click the right arrow)
* The edit summary if the user wrote one


On the top left above the page content and to the left of the page tabs is a search box.
If there is several edits to one page on the same day they are grouped together.  They can be shown as separate lines if you click on the triangle.


==== Sidebar ====
If there is a huge amount of minor edits you can hide them by clicking ''Hide minor edits'' in the ''Recent changes options'' box at the top of the page.
[[File:FlightGear wiki sidebar.png|frame|right|The sidebar]]


To the near top left is the ''sidebar'' with:
== Your watchlist ==
The ''watchlist'' will help you keep track of interesting pages if the recent changes page is too busy.


:; Navigation links
The watchlist presents changes the same way as the recent changes page.
:: To some pages deemed important enough to link to from every page:
::; The main page of the wiki
::: Where you end up when going to http://wiki.flightgear.org
::; The recent changes page
::: Listing all the latest changes on the wiki
::; A random article
::; The village pump
::: The [[FlightGear wiki:Village pump|village pump]] is the page for wiki discussion not related to a particular page or user.
::; The summary of help pages
::; The portal pages
:; FlightGear web sites :
::* The main website, http://flightgear.org
::* The forum, http://forum.flightgear.org
::* The {{tickets|bug tracker}} at SourceForge
::* Links to info on [[Current events|events]], like expositions where FlightGear developers can or have met in real life
:; Toolbox
:: Slightly dependent on the type of page you are viewing
::* A summary of pages linking to the page you are viewing
::* A summary of edits related to the page you are viewing
::* The upload wizard
::* A set of special pages, with information on pages, categories, files and users
::* A more printer-friendly version of the page
::* A link to the particular version of the page you are viewing.
::* Information about the page you are viewing
:; Language links
:: To versions of the page in other languages


==== Category links ====
The watchlist is accessible from a link in the top right corner of every wiki pages when you have logged in.
[[File:FlightGear wiki category links.png|frame|none|The category links]]
At the bottom of the page should be links to one or more category pages, which are listing pages in that category.


==== Page footer ====
Pages can be added to it either by clicking the ''watch tab'' (the star icon tab) or by clicking the "Watch this page" box below the edit summary text box when editing or creating a new page.
[[File:FlightGear wiki page footer.png|frame|none|The page footer]]
The page footer have some information related to the page and to the wiki in general, such as the license, privacy policy and terms of use.


Through the "Mobile view"/"Desktop view" links one can change between the desktop and mobile views.
== Page revision history ==
 
The ''revision history'' of a page, accessible from the history tab, holds all the changes to a page.  Some data regarding deleted revisions is only available to users with sufficient rights.
=== Typical article layout ===
==== Messageboxes ====
At top of some articles there can be ''messageboxes'' with general notices about the article.  These could for example state that an article could be out of date, contain factual errors or is to be deleted.
 
Sometimes there are messageboxes in other places in article as well.
 
==== First section ====
The first section of the article, before the table of contents should contain a summary of the article.  Sometimes you might instead find this information further down in a section named something like ''Goal'', ''Background'', but this practice is discouraged.
 
==== Infobox ====
On the top left in many articles you can find an ''infobox'' with a summary of information relevant to articles about certain subjects, for example aircraft, airports and software.
 
==== Navbox ====
Below the infobox or at the bottom of the page there is often a ''navbox'' with links to related articles in a series of articles.
 
==== Links to related FlightGear resources ====
At the bottom of the article you can find links to related wiki articles and FlightGear project web pages like forum topics, developer mailing list threads and source code.
 
==== Links to external resources ====
Sometimes there is also links to pages external to the project.
 
==== Category links ====
At the very bottom of an article there should be ''category links'' to category pages which list all pages in a category with pages on the same subject.
 
== Wiki features ==
=== Main characteristics ===
The two main characteristics of a wiki that like the FlightGear are using the MediaWiki software are:
 
* Anyone can register and edit most pages
* The edit history of all pages is ''preserved'' and is available to everyone
 
This allows for very transparent collaboration.
 
=== Tracking changes ===
As the ''revision history'' of pages is kept, changes can be tracked in various ways.
 
==== Recent changes ====
The page [[Special:RecentChanges]] is a list of all the recent changes on the wiki.
 
If you want to have a feel about what is going on on the wiki you could start your wiki session by having a peek at that page.


Some of the things visible there is:
[[File:FlightGear wiki revision history.png|none|frame|The top of the revision history of a page]]


* Edits to pages
The revision history allow you to look at and compare selected revisions using ''page diffs'' (or often just ''diffs''), as well as link to a certain revision or comparison of revisions.
* Creation of new pages
* File uploads, usually images
* Creation of new users
* Pages being protected
* Deletion of pages or files


As it shows all the latest changes it is often the place where one will find any spam, vandalism or other unwanted edits.
== Page diffs ==
{{tip|If you need to compare two separate pages you can do so with [[Special:ComparePages]].}}
{{tip|By pressing the ''Show changes'' button when you edit a page you can see your changes as a diff. It can be useful when writing the edit summary.}}


==== Watchlist ====
A ''diff'' is comparison showing the differences between two revisions of a page, much like the <code>diff</code> utility in some operating systems. With them you can see what was changed, added or removed in a revision.
The ''wathlist'' will help you keep track of interesting pages if the recent changes page is too busy.


The watchlist is accessible from a link in the top right corner of every wiki pages when you have logged in.
A diff page is typically shown with the actual diff at the top of the page and the rendered page as of the latter revision at the bottom of the page.


At first the watchlist will be empty, but pages can be added to it by clicking the ''watch tab'' (the star icon tab) or by clicking the "Watch this page" box below the edit summary text box when editing or creating a new page.
The diff itself is split into two columns: Typically the old one to the left and new one to the right.


==== Page revision history ====
On top you have the dates and usernames as well as the edit summaries added before saving the revisionsBelow that are the changed chunks of lines and a few lines surrounding them.
The ''revision history'' of a page, accessible from the history tab, holds all the changes to a pageSome data regarding deleted revisions is only available to users with sufficient rights.


The revision history allows you to look at and compare selected revisions using ''page diffs'' (or often just ''diffs''), as well as link to a certain revision or comparison of revisions.
[[File:FlightGear wiki diff.png|none|frame|The diff part of a diff page]]


=== Types of pages ===
{{tip|If [[User:Johan G|Johan G]] above had used the ''Show preview'' button more he might have remembered to add the other changes as well.}}
In addition there are several types of pages.  These different types of pages are usually separated in different ''namespaces'':


:; Articles
== Finding a specific edit to a page ==
:: Pages in the main namespace, making up the most of the wikis content.
[[File:Finding an edit using successive approximation.png|left|thumb|200 px|Finding an edit through successive approximation.]]
;; Files
:: Generally images used to illustrate the wiki.
:; Categories
:: Grouping together pages with similar content in a somewhat hierarchical fashion.
:; Templates
:: That are used when the wiki editors either want content to be presented in a consistent manner or to lessen the amount of typing needed for common things like repository links etc.
:; User pages
:: Where users can present themselves, have to-do lists etc.
:; Discussion pages
:: These are used for discussions about the wiki, individual pages and with users.
:; Portals
:; Howto pages
:; Help pages
:: Like the one you are reading now.


It may not be obvious at first, but pages in these namespaces are used in different ways, many of them are for example linked to in very different ways.
If you are looking for when a particular section of text was edited, you can use ''binary search''/''successive approximation''.


=== Wiki markup ===
Start by comparing the revision ''between'' the oldest and newest possible revision with ''its previous'' revisionThen in ''halfway steps'' compare revisions with their previous ones till you find the edit.
To format the text of the wiki, adding images etc, ''wiki markup'' or ''wikitext'' is usedFor a summary see [[Help:Your first article]] and for details, see [[Help:Formatting]].


== Whats next? ==
This can come in handy for example if you want to discuss a confusing phrasing with the user who added it, if you want to sign an unsigned comment on a discussion page with {{tl|unsigned}}, or if you are an administrator and need to find a specific user due to spam etc.
* [[Portal:Wiki]]
* [[Help:Your first article]]


[[Category:Help]]
[[Category:Help]]

Revision as of 14:41, 20 August 2020

Tip

Giving a comprehensive and concise edit summary will help other understand the revision history.

Why the edit was done is more useful than what was edited — a diff will show what was edited but not why.

Tip

You can help fighting spam by checking recent changes when you log in on the wiki.


Tracking changes on the wiki is relatively easy. One of the main characteristics of the MediaWiki software the FlightGear wiki is using is that the revision history of all pages are preserved and available to everyone. This allows for very transparent collaboration.

Notification of edits to your discussion page

You will be notified if someone else edit your discussion page. The next time you log in on the wiki or load a page you will see a notification that there are new messages on your discussion page.

You can also optionally change your preferences so that you will receive an email if your discussion page have been edited.

Recent changes to the wiki

The page Special:RecentChanges is a list of all the recent changes on the wiki.

If you want to have a feel about what is going on on the wiki you could start your wiki session by having a peek at that page.

Some of the things visible there are:

  • Edits to pages
  • Creation of new pages
  • File uploads, usually images
  • Creation of new users
  • Pages being protected
  • Deletion of pages or files

As it shows all the latest changes it is often the place where one will find any spam, vandalism or other unwanted edits.

If you are logged in, changes to pages that are on your watchlist will be highlighted in bold.

One days changes will for example look like below:

Recent changes on the wiki. Only some users have rights to block users.

For each row you will see

  • A mark indicating for example N for new pages and m for minor changes (if the user marked that checkbox when saving his edit of the page)
  • The time of the revision (in the time zone set in your preferences (see Preferences link on the top right of every page)
  • A link with the title of the page to the revision of the page
  • A link cur linking to a diff comparing the revision with the current revision
  • A link prev linking to a diff comparing the revision with the previous revision
  • The number of characters added or removed in the edit
  • A link with the name of the user who did the edit linking to his user page
  • A link talk linking to the users discussion page
  • A link contrib linking to to a list of the users contributions
  • A link to the article section that was edited if the user edited a specific section (click the right arrow)
  • The edit summary if the user wrote one

If there is several edits to one page on the same day they are grouped together. They can be shown as separate lines if you click on the triangle.

If there is a huge amount of minor edits you can hide them by clicking Hide minor edits in the Recent changes options box at the top of the page.

Your watchlist

The watchlist will help you keep track of interesting pages if the recent changes page is too busy.

The watchlist presents changes the same way as the recent changes page.

The watchlist is accessible from a link in the top right corner of every wiki pages when you have logged in.

Pages can be added to it either by clicking the watch tab (the star icon tab) or by clicking the "Watch this page" box below the edit summary text box when editing or creating a new page.

Page revision history

The revision history of a page, accessible from the history tab, holds all the changes to a page. Some data regarding deleted revisions is only available to users with sufficient rights.

The top of the revision history of a page

The revision history allow you to look at and compare selected revisions using page diffs (or often just diffs), as well as link to a certain revision or comparison of revisions.

Page diffs

Tip  If you need to compare two separate pages you can do so with Special:ComparePages.
Tip  By pressing the Show changes button when you edit a page you can see your changes as a diff. It can be useful when writing the edit summary.

A diff is comparison showing the differences between two revisions of a page, much like the diff utility in some operating systems. With them you can see what was changed, added or removed in a revision.

A diff page is typically shown with the actual diff at the top of the page and the rendered page as of the latter revision at the bottom of the page.

The diff itself is split into two columns: Typically the old one to the left and new one to the right.

On top you have the dates and usernames as well as the edit summaries added before saving the revisions. Below that are the changed chunks of lines and a few lines surrounding them.

The diff part of a diff page
Tip  If Johan G above had used the Show preview button more he might have remembered to add the other changes as well.

Finding a specific edit to a page

Finding an edit through successive approximation.

If you are looking for when a particular section of text was edited, you can use binary search/successive approximation.

Start by comparing the revision between the oldest and newest possible revision with its previous revision. Then in halfway steps compare revisions with their previous ones till you find the edit.

This can come in handy for example if you want to discuss a confusing phrasing with the user who added it, if you want to sign an unsigned comment on a discussion page with {{unsigned}}, or if you are an administrator and need to find a specific user due to spam etc.