Wiki Overhaul

Moderator: Unholy

Wiki Overhaul

Postby imper1um » Thu Jun 21, 2012 2:57 pm

This is coming from another post. Before this was suggested, I was already working on a Wiki, but someone suggested I move this to another post.

imper1um wrote:
mapcat wrote:
imper1um wrote:Well, I'm Working on something

I applaud your effort. This is a huge task. Taking it on at one week in, you're a bold one.

I love taking on things like this...my OCD kicks in and since I'm a programmer, I use all of my skills to their full use. Its a learning experience for me, and a fun task.

I'm also a very standards oriented person, so you'll see a lot of "standards" that are the same.

The plan:
- Rewrite the structure to something closer to current wikis. Remove all "this is what you do" from the main page to stop it from becoming an "information spew" on the first page you see.
- Establish a standards structure for the layout of the site, including templates and such.
- Build main "overview" pages for use and begin requests for people making translations (if possible)
- Build side "definition" pages for use, and begin requests for people making translations (if possible).

The general idea:
1. We need to remove the "information spew" on every page. Finding information is hard. Really hard.
2. Clean up the look of each of the pages so that it looks like someone (semi) professional did the pages.
3. Establish a translation protocol for all of the pages, so that translated pages go to translated pages (/es goes to /es, instead of /es to /en).

It will take some time, but I'll probably need help in the future building a few pages, but I'm going to generate the structure before that happens, which shouldn't be long.


The entire overhaul is currently on my User:Imper1um page located at http://www.waze.com/wiki/index.php/User:Imper1um/Overhaul. To make it easy to move things, and make it easy for me to run a script at the end of the overhaul to replace the wiki, I'm going to keep the same initial structure (all links begin with "User:Imper1um/Overhaul/"). When the overhaul is finished, I have a massive script that runs, rooting it all out. It also helps that something under construction like this will be completely separate from the current wiki.

At the moment, I'm not particularly looking for help, but if you want to offer it, I won't refuse it. In the future, I will need the following help:

1. Better wording of the general idea. At the moment, I am just simply "creating the structure", which I allocate 30 seconds for me to think up of a small amount of sentences to say about the specified subject. If someone is particularly good with expanding on ideas (show, not tell), it would help if someone could come up behind me, edit the pages with better descriptions of each of the ideas.

2. Categorization. I plan on doing this afterwards, but if someone can also edit the pages to put effective categories on the pages. I need people who are versed in organization to do this.

3. Translation. I only know English, but I know it well. If you know English and another language, please, create a page with <PAGENAME>/<language>, translating the page. Regardless, make sure you add {{Template:User:Imper1um/Overhaul}} to the top of the page to signify that it is an Overhaul page. Also, make sure you use "two-character language" notation. This is generally the first two characters of your language (with some exceptions). For example, Spanish is "es", French is "fr". Don't know your language two-character notation? Go to wikipedia.org, choose your language, and note the "XX.wikipedia.org". For example, Italian will be "it.wikipedia.org".

4. Pictures. I need someone to place pictures effectively into the wiki. This needs to be done AFTER #1.

5. I need someone with Wiki Admin access to add the following to the CSS Stylesheet:
Code: Select all
.bodyContent .top .topImage
{
 background-image: url('http://www.waze.com/wiki/images/8/87/Top.png');
}


Hopefully soon we can get rid of this "information spew" that we have on the Wiki.

Thanks!
imper1um
 
Posts: 32
Joined: Wed Jun 13, 2012 9:43 pm
Has thanked: 0 time
Been thanked: 1 time

Re: Wiki Overhaul

Postby kentsmith9 » Sat Jun 23, 2012 3:25 am

imper1um,

# I mainly use FF and can assist on that front with feedback. The operation is the same between them. The only difference is the few "problems" that FF does not behave correctly.

# My R/L job is writing about technical things for the average human, so I can work with you on the intro descriptions. We can sync up on how you want me to follow you. I can just watch your edits if you like, or you can maybe add a special template to pages that need an intro like {{INTRO_NEEDED}} and I can search for them and edit as you create them.

# As I mentioned in my PM to you yesterday, I will keep adding updates and simplifications to sections that you can then cut and paste into your template. I just realized that we need to keep synchronized on our changes though since you will at some point do a wholesale paste from your temp page and if I was updating the current pages, the changes will be "lost" when we switch over. Maybe I will focus my efforts on the section intros inside your temp pages so we don't risk loosing too much work between us.

One way or another I think we will be successful here.
kentsmith9
Waze Global Champs
Waze Global Champs
 
Posts: 5544
Joined: Mon Apr 23, 2012 3:33 pm
Location: SF/SJ Bay Area of Northern California
Has thanked: 1473 times
Been thanked: 1684 times

Re: Wiki Overhaul

Postby imper1um » Thu Jun 21, 2012 7:38 pm

1. Cartouche documentation will be logged and stored away. More emphesis on the new engine should be used since it causes less problems and is much more supported.

2. I'm going to need some documentation on the minimum requirements for WME. The problem is that WME I know works in Chrome because I use Chrome, however, I would like to know how it works in other Browsers, and perhaps establish a "lowend version" for what browsers can and cannot be used in WME. I'm busy with work, wiki, road editing, and Pathfinder Society all the time that I can't really go version testing.

3. For the most part, the entire wiki structure should be based on providing people the information on as it is clicked, not spewed out in front of the user. Simple headlines should only be provided with more information at a click, like most Wikis. So, if someone is just using the Client and wants to get the lo-down on a feature and its nuances, I don't want the screen cluttered with information about Cartouche.

4. Ultimately, the wiki should be set that everything should be "at-a-click." Want to know the definition of a word that only exists in WME? It should be clickable.

5. Wiki documentation should be <= 2 scrolls on a 950px height screen with sufficient (950px width+) width for the documentation. This allows for less information spew and more information "conciseness." You tell people what they want to know, not explain about everything what is going on.
imper1um
 
Posts: 32
Joined: Wed Jun 13, 2012 9:43 pm
Has thanked: 0 time
Been thanked: 1 time

Re: Wiki Overhaul

Postby jasonh300 » Thu Jun 21, 2012 6:36 pm

The functionality to view the routes in WME already exists. You can click on the links from within WME...but for new users, it's a chicken and egg conundrum. All they have to do is get those links onto the Dashboard page.

Then there's the whole Alternate Name field, which some editors spend a lot of time filling in. That data may or may not be useful when they finally make an alternate name field or shield field in WME. I don't see any way that they're going to be able to differentiate between shield numbers and alternate names and we're going to have a lot of new work to do once that change occurs.

Personally, I don't do any alternate naming. I'm working on getting the highways in Louisiana the way I think they should be (consistent), and whenever the new alternate naming/shields come into play, I'll have a pretty easy time of doing a Select All and filling in the data. It won't happen overnight, but at least I won't have to spend a lot of time going segment by segment all over again, as I'm doing now.
jasonh300
 
Posts: 7568
Joined: Fri Oct 28, 2011 4:26 pm
Location: New Orleans, LA, USA
Has thanked: 408 times
Been thanked: 986 times

Re: Wiki Overhaul

Postby gettingthere » Thu Jun 21, 2012 5:54 pm

jasonh300 wrote:However, as long as the Recent Routes on the Dashboard page leads every new user to Cartouche, new editors will be using Cartouche, screwing things up and creating new problems.


Urgh.... Waze needs to get that removed from there and / or get the links going to WME instead. How many months late are these changes? Is Waze even keeping track of what is remaining to be done to get rid of Cartouche?
gettingthere
Waze Global Champs
Waze Global Champs
 
Posts: 6088
Joined: Fri Nov 05, 2010 5:30 am
Location: Southern California, USA
Has thanked: 42 times
Been thanked: 208 times

Re: Wiki Overhaul

Postby jasonh300 » Thu Jun 21, 2012 5:51 pm

About a month ago, I segregated all the Cartouche stuff on the BMEP page to the bottom of the page and put in info stating that it's only there for some legacy functions.

However, as long as the Recent Routes on the Dashboard page leads every new user to Cartouche, new editors will be using Cartouche, screwing things up and creating new problems.
jasonh300
 
Posts: 7568
Joined: Fri Oct 28, 2011 4:26 pm
Location: New Orleans, LA, USA
Has thanked: 408 times
Been thanked: 986 times

Re: Wiki Overhaul

Postby gettingthere » Thu Jun 21, 2012 5:00 pm

Should all of the legacy Cartouche map editing instructions be removed? It confuses new editors and Cartouche should not be used any more.
gettingthere
Waze Global Champs
Waze Global Champs
 
Posts: 6088
Joined: Fri Nov 05, 2010 5:30 am
Location: Southern California, USA
Has thanked: 42 times
Been thanked: 208 times

Re: Wiki Overhaul

Postby jasonh300 » Thu Jun 21, 2012 4:53 pm

The "Best Map Editing Practice" page can be copied verbatim into the new Wiki since it's updated frequently.
jasonh300
 
Posts: 7568
Joined: Fri Oct 28, 2011 4:26 pm
Location: New Orleans, LA, USA
Has thanked: 408 times
Been thanked: 986 times

Re: Re: Wiki Overhaul

Postby dmcconachie » Thu Jun 21, 2012 6:06 pm

gettingthere wrote:
jasonh300 wrote:However, as long as the Recent Routes on the Dashboard page leads every new user to Cartouche, new editors will be using Cartouche, screwing things up and creating new problems.


Urgh.... Waze needs to get that removed from there and / or get the links going to WME instead. How many months late are these changes? Is Waze even keeping track of what is remaining to be done to get rid of Cartouche?

Livemap reported problems still go to cartouche too as far as I'm aware!

It's as bad as the beta feedback being ignored. We're told that cartouche is responsible for most of the database failures yet it still sits there like a little waze wart!

via Tapatalk
dmcconachie
 
Posts: 6119
Joined: Sat May 22, 2010 11:44 pm
Location: Edinburgh, UK
Has thanked: 106 times
Been thanked: 310 times

Re: Re: Wiki Overhaul

Postby gettingthere » Thu Jun 21, 2012 5:12 pm

dmcconachie wrote:Can it be archived somehow? Probably a lot of valuable info there that we might not want to lose completely!


If it's general information related to Waze, editing maps, and current, it should be integrated into the Wiki in the proper place. If it's specific information on how to edit using Cartouche, why do we need to keep it?
gettingthere
Waze Global Champs
Waze Global Champs
 
Posts: 6088
Joined: Fri Nov 05, 2010 5:30 am
Location: Southern California, USA
Has thanked: 42 times
Been thanked: 208 times

Next

Return to Wiki Updates and Discussion

Who is online

Users browsing this forum: herrchin