CZ:Userinfo System: Difference between revisions

From Citizendium
Jump to navigation Jump to search
imported>Larry Sanger
imported>Larry Sanger
Line 57: Line 57:
  ...
  ...


'''Don't add or touch anything except to the right of the equals signs.'''  When finished adding these two bits of data, press <code>Save page</code>.
'''Don't add or touch anything except to the right of the equals signs.'''  When finished adding these two bits of data, press <code>Save page</code>.  Note that this step will ''only'' create a data file.  You have to do more to create the neat, human-readable table.  For that, you need to do the next step.


=== Step 4 ===
=== Step 4 ===

Revision as of 13:35, 23 January 2008

The userinfo system is a (developing) system to track information about users, their CZ plans, CZ accomplishments, and so forth. Once fully developed, the system will allow you to see at a glance both your own "work roadmap" for CZ (example)--where you've been, where you're going--and overall views of work by everyone on CZ (example), or in a particular workgroup, or on a particular initiative. All you have to do is fill in some blanks, and the data will be distributed to different points around the wiki.

It's a way for the whole project to come together and get organized!

Examples

See CZ:Group Status‎ for an example of central aggregation of user data.

See User:Larry Sanger/Userplan for an example of a user infobox.

The data for that page is stored in two places:

The data is structured by two templates: Template:Userplan-all and Template:Userplan-all-workgroup.

How the system is planned to work

Ideally, all active Citizens would start their own data pages, like Template:User/Larry Sanger. They fill in a lot of information: their short- and long-term CZ plans, their recent and most important CZ achievements, top articles they're working on, and their roles in the system, as well as some notes. (We can add new data types later.) In addition, Citizens fill in similar sorts of information with regard to the workgroups in which they are most active, like Template:User/Larry Sanger/Philosophy. For instance, you might list out your goals for your work in the Biology Workgroup in the next week.

Once this data is filled in, we collect it and display it in various ways. First, of course, you can display all of your own data in one place, like User:Larry Sanger/Userplan does. But just as importantly, we can produce other kinds of tables, which we place on various workgroup pages (like CZ:Chemistry Workgroup), or initiative pages (like CZ:Recruitment). From a single place, you can see

  • Who the active contributors are in a given workgroup/initiative.
  • What they're working on; so, who to contact for help with a certain effort.
  • Whether there is a workgroup/initiative need that is unmet.

This will, in turn, allow us to "get organized" in a way we haven't been. But it's all done bottom-up!

For a live example, see CZ:Group Status.

How to get started

Getting started with the user infobox system is somewhat involved: it should be pretty easy for many experienced wiki users, but for some people, it might be challenging. If you take it step-by-step and ask for help (try the talk page) when you need it, it shouldn't be too painful.

(This should get easier with time. The following instructions are for people who want to do "beta testing.")

Step 1

Get familiar with the system. Study the description above.

Step 2

Next, start your general user info page (this will be a data file, used by the pretty table). Use this little box:


Be sure to replace REPLACE_THIS with your precise user name (exactly what you use to log in). Leave the rest there. For example, Larry Sanger might write in the box: Template:User/Larry Sanger Then press the button. Be sure to read through the next step before doing anything else.

Step 3

When you arrive at your user info page, you should see a bunch of code in the text box. You could fill in all the blanks after the = signs at this point, but for now, just do the first two. For now, just look at the first ten lines of code, or so. There are two sections there: "last updated" and "Location of userplan." Fill those out now. You'll be putting in a date and a wiki page location. Look for special lines with one equals sign on them (=). Those are the lines you add your info to. For example, Larry might write:

...
| updated = Jan. 13
...
| userplan-page = User:Larry Sanger/Userplan
...

Don't add or touch anything except to the right of the equals signs. When finished adding these two bits of data, press Save page. Note that this step will only create a data file. You have to do more to create the neat, human-readable table. For that, you need to do the next step.

Step 4

Next, go to your user page, or a subpage of your user page--wherever you want to see your userbox. Wherever you want your user box to appear, paste this: {{Userplan-all|User Name}} Replace "User Name" with your precise user name (exact capitalization, punctuation, and spelling are all required). For example, Larry would write: {{Userplan-all|Larry Sanger}} In fact, if you go here, you'll see that that's all Larry had to put in, in order to generate that whole table.

When you're done writing that one line, press Save page. A big, empty infobox should pop up.

Step 5

Edit your info! On that page, you'll see a lot of fairly self-explanatory headers, and next to the headers, you should see little "edit" links. Go ahead and press them. You'll be presented with some code, interspersed with lines that look like this, for example:

| plans-wk-1 = 

If you look above those lines, for the text that follows <!--, you'll see: "Plans for this week (please update regularly)..." So, if you've got any general plans for the week on CZ, put 'em in across from the = signs. You write what you want after the equals signs, as long as you don't hit the enter key; generally, don't touch anything else on the page, or you could mess up the presentation of your table. One item per line, five lines per list.

Go through the whole list, if you like, but be sure you Save page after each section. You can edit the whole thing at once by following the "edit" link at the very top of the whole table. That is also where to edit "last updated" (at the top of the page, the line that reads | updated = ).

Step 6 (optional)

If you do a lot of work in a particular workgroup or initiative, then you can create another, more specialized user info box, with your plans and doings just for that workgroup or initiative. You can create these for as many workgroups and initiatives as you do work in, and all the info will show up in your "master infobox" you created above.

All you have to do create new data pages, one for each workgroup or initiative. The data structure for workgroup info is (at present) almost exactly the same as for general info; so, you can fill out the same sorts of plans, lists of accomplishments, articles, etc., but for the workgroup "level."


Be sure to replace USER_NAME with your user name, and then replace WORKGROUP with one (only one!) of the workgroup codes below. (If you want to create information for another workgroup, you'll have to create a separate info page for it.) Leave the rest there. For example, Larry Sanger might write in the box: Template:User/Larry Sanger/Philosophy Then press the button.

Here's a list of workgroup codes. It's important that you use these precisely, including capitalization but without the comma. Astronomy, Biology, Chemistry, Earth-sci, Mathematics, Physics, Anthropology, Archaeology, Economics, Education, Geography, Law, Linguistics, Politics, Psychology, Sociology, Classics, History, Literature, Philosophy, Religion, Architecture, Music, Theater, Visual-arts, Agriculture, Business, Computers, Engineering, Healing-arts, Health-sci, Journalism, Info-sci, Media, Military, Games, Hobbies, Sports

Here's a list of initiative codes. Use these precisely, including capitalization. (Initiatives coming soon.)

Step 7

Add your exact username to this list, (the result can be viewed at CZ:Group Status), then Save page and observe the results.


Citizendium Technical Help
How to edit an article | Searching | Start article with subpages
The Article Checklist | Subpage template

|width=10% align=center style="background:#F5F5F5"|  |}