GeoGebra Manual:Village Pump

From GeoGebra Manual
Revision as of 22:44, 2 November 2010 by Zbynek (talk | contribs) (some ideas on translation)
Jump to: navigation, search

This is our little local village pump (inspired by Wikipedia). This place is intended for discussions about the GeoGebraWiki itself. If you want to contribute more to this wiki than adding examples and comments, please add your project idea to the list below for discussions or let us know what you are working on. If you need to change a lot of pages for your idea please contact Florian Sonner – there might be a more simple solution.

Wiki Structure

Attention.png

Please read or at least skim through the following pages if you want to help us. The listed pages contain vital information which help you understand the internal structure of this wiki.

  • Project description – a forum post which contains an introduction why this project has been started
  • Official MediaWiki Help Document – describes the functionality and idea of a wiki and the commands you can use to edit a page
  • GeoGebraWiki Structure – describes the structure of this wiki (e.g. the namespaces used)
  • Manual Structure – describes the special structure of the manual and the reasons behind this
  • How To – instructions how to perform certain common tasks

How to organize the knowledge about GeoGebra? Write down your ideas and let it discuss by the community!

Village-Pump-Workers

Who wants to help? Tell about you knowledge and write down you ideas at you user-page -> GeoGebraWiki:Village_Pump/Workers.

Projects

Manual

Just tool and command pages were transferred from the old manual until now, but the manual consists of a lot more which has to be transferred. Before transferring the content we also have to think about a way to organize the content in a more wiki-like way. --Florian Sonner 16:52, 18 May 2010 (UTC)

As I already mentioned somewhere: In my opinion there are more kind of keywords necessary like:
  • Object ...
  • Property ... exemple: the name of an object
  • View ... names for "visible" parts, not only the main parts like graficview, algebraview, ... but for little parts like columns, rows and cell, too
  • Menu ... mainmenu, submenu and commands there
Hope it is not too late, but the pagenames Category:Tools would be better readable, if the "Tool" is in brackets: Angle Tool -> Angle (Tool).
--Birgit Lachner
  • not sure what you mean by "keywords". Categories? Use of categories should be automatized via the infoboxes.
  • renaming articles
    1. maybe too late
    2. generally it's better to have as few non-letters in URL as possible

--Kondr 23:09, 18 June 2010 (UTC)

Yes I ment Categories. In the last months a lot was changed. Seems to be on a good way! If I could help to do some slavery-work for you ... like adding the templates (note, exemple, ...) ... call me. --Birgit Lachner 07:24, 31 August 2010 (UTC)
Contributions are always welcome! :) We already have Template:Note and Template:Example but not all command / tool pages use them, it would be great if you could add them to these pages if necessary. --Florian Sonner 22:12, 31 August 2010 (UTC)

Changelog

We should start a changelog which contains information about changed commands and tools, so that documentation can be changed easily on new release. No sense to do it now, but will be useful for 4.0 -> 4.2 transition.

Since there hasn't been any changelog till now, please look at Category:Outdated, pick a page, make sure it's compatible with 4.0 and set version parameter of Template:Manual Page to either 3.2 or 4.0, depending on whether the content of that page has changed between 3.2 and 4.0 manuals.

Reference

  • XML guide: Reference:Xml contains complete XML reference. In the future it would be nice to have a short tutorial on that page, since the auto-generated articles are not exactly easy to read.

Multi-language sidekicks

I guess we could

  • start Interwiki
  • use version parameter to show some "outdated infobox" + outdated category if version of sideḱick article is older than English one
  • prepare a script, which generates Command and Tool pages from 3.2 manual including cross-language link to English original (I guess the English ones were generated by such script), set version of all auto-generated pages to 3.2
  • in each sidekick create a "translation progress" page which contains mapping of English -> non-English article mapping + some info about outdated pages
  • to Talk of each non-tool & non-command page add something like "translation start point" pointing to appropriate current help node

Translation would work like this:

  • user looks at the "translation progress" page and picks an untranslated article
  • creates translation, sets version to match English version
  • adds cross-language link to English article
  • once all pages are translated, user looks at "outdated" list ad picks an article
  • creates translation, sets version to match English version
  • once all articles are created, one has to set their order in the book. May be done by bots, but user assistance would help.
  • if user is not capable of using wiki properly, she can add some "cleanup required" template and someone with more wiki skills will help.


Templates

Infoboxes

see Project:Village Pump/Infobox for details

  • Tools (Manual) -- done
  • Commands(Manual)
  • GUI (Manual) -- done
  • Objects (Manual)
  • Events
  • Tutorials
  • GeoGebra Institute

Microtemplates

  • example
  • note
  • ggb and ggt templates from old wiki

... and a short guide on how and when these should be used

Wanted extensions

© 2024 International GeoGebra Institute