Skip to content
  • Categories
  • Recent
  • Tags
  • Popular
  • Users
  • Groups
  • Search
  • Get Qt Extensions
  • Unsolved
Collapse
Brand Logo
  1. Home
  2. Behind the Scenes
  3. Wiki Discussion
  4. Wiki Week

Wiki Week

Scheduled Pinned Locked Moved Wiki Discussion
wikicleanupevent
31 Posts 4 Posters 20.0k Views
  • Oldest to Newest
  • Newest to Oldest
  • Most Votes
Reply
  • Reply as topic
Log in to reply
This topic has been deleted. Only users with topic management privileges can see it.
  • T Offline
    T Offline
    tekojo
    wrote on 11 May 2015, 11:28 last edited by
    #1

    Hello everyone,

    As written in the blog http://blog.qt.io/blog/2015/05/05/announcing-wiki-week/ we are having a Wiki Week to clean up the wiki a bit.
    The event will be running next week

    The Wiki page for things to do is here: https://wiki.qt.io/Wiki_Week
    Feel free to add things there.

    Any suggestions and ideas are welcome, you can post here or on the wiki.

    Let's make the wiki a better place!

    1 Reply Last reply
    0
    • ? Offline
      ? Offline
      A Former User
      wrote on 11 May 2015, 19:50 last edited by
      #2

      Hi,
      I have a suggestion, but maybe it is too much work: The organization of articles in languages others then English is pretty bad. I suggest to do it like Wikipedia and have subdomains with dedicated mediawikis for all supported languages and create links between articles in different language versions.

      T 1 Reply Last reply 12 May 2015, 11:16
      1
      • S Offline
        S Offline
        SGaist
        Lifetime Qt Champion
        wrote on 11 May 2015, 19:52 last edited by
        #3

        @Wieland's idea sounds very good !

        Interested in AI ? www.idiap.ch
        Please read the Qt Code of Conduct - https://forum.qt.io/topic/113070/qt-code-of-conduct

        1 Reply Last reply
        0
        • ? A Former User
          11 May 2015, 19:50

          Hi,
          I have a suggestion, but maybe it is too much work: The organization of articles in languages others then English is pretty bad. I suggest to do it like Wikipedia and have subdomains with dedicated mediawikis for all supported languages and create links between articles in different language versions.

          T Offline
          T Offline
          tekojo
          wrote on 12 May 2015, 11:16 last edited by
          #4

          @Wieland my first reaction is that subdomains are a bit heavy.
          But then again, maybe we can try. At least make a list of what it would require.

          Would you add that to the wiki page?

          ? 1 Reply Last reply 12 May 2015, 17:18
          0
          • J Offline
            J Offline
            JKSH
            Moderators
            wrote on 12 May 2015, 11:35 last edited by
            #5

            The current organization for translations is similar to MediaWiki.org itself (e.g. see the bar at the top of http://www.mediawiki.org/wiki/Help:Editing_pages)

            What are we lacking? What benefits can subdomains provide?

            Qt Doc Search for browsers: forum.qt.io/topic/35616/web-browser-extension-for-improved-doc-searches

            1 Reply Last reply
            0
            • ? Offline
              ? Offline
              A Former User
              wrote on 12 May 2015, 13:02 last edited by
              #6

              First of all one has to decide if multiple languages are needed for a programmers wiki, as one would assume that most "computer guys" more or less speak English. I'd say that there is a need for wiki contents in other languages, at least to make life easier for young people (say: pupils) who don't understand English, yet. My experience is that it is already hard enough to find Qt developers so we should lower the burden for beginners as much as possible. This means we need to create the best UX on our wiki. Now, let's compare Wikipedia and wiki.qt.io:

              Wikipedia start page: https://drive.google.com/file/d/0B2D1UtsPfTx-MzQtMXRrdFczeTQ/view?usp=sharing

              wiki.qt.io start page: https://drive.google.com/file/d/0B2D1UtsPfTx-R3Z4YUxma25hams/view?usp=sharing

              => Wikipedia starts with a language selection. Very easy to understand on first sight. The Qt-wiki starts with a page completely in English with the language switch in the upper area. Most people will recognize that this Qt site looks "like Wikipedia" just because everyone on this planet nows Wikipedia. So the instinctive reaction is to look for other languages on the left of the page. But it's not there. Also the language switch doesn't use language names in their actual languages but ISO country codes that are more or less cryptic, esp. when you're not used to use latin alphabets.

              Ok, now I click on "DE" and land on this page: https://drive.google.com/file/d/0B2D1UtsPfTx-Ui1TeEZxQkJnSjQ/view?usp=sharing

              => On the German Wikipedia each page has a German name, e.g. the "main page" is named "Hauptseite" http://de.wikipedia.org/wiki/Wikipedia:Hauptseite . On the Qt wiki it is named "Main/de". And not only doesn't the URI give a useful name to non-English speakers the big title on top of the page also says "Main/de".

              => The side bar and all other controls are still in English although I explicitly switch to a German page. If I wanted to change this I needed to sign up and log in first. How many people will do this when they just landed on this page coming from Google search? I think it's safe to say "no one".

              => Let's scroll down a bit. It says "Lernen (Übersicht)" - Lern (overview) - and below this is a link to code snippets. I hover over it and the popup says "Category:Snippets". Well, I don't know, I don't speak English. I click on it. And I land on this page: https://drive.google.com/file/d/0B2D1UtsPfTx-cS0xQ1NneUU3SHM/view?usp=sharing
              It is an overview over all articles that are tagged as snippets. As there seems to be no German version of this (autogenerated?) page it defaults to English. The overview contains all articles in all languages in a huge list. But still the German articles have an English title (which I don't understand) suffixed by "/de".

              And I could go on with this! There is only one way to fix all of these issues and this is to create dedicated mediawiki instances for all the languages. And this implies the use of subdomains.

              1 Reply Last reply
              0
              • T tekojo
                12 May 2015, 11:16

                @Wieland my first reaction is that subdomains are a bit heavy.
                But then again, maybe we can try. At least make a list of what it would require.

                Would you add that to the wiki page?

                ? Offline
                ? Offline
                A Former User
                wrote on 12 May 2015, 17:18 last edited by
                #7

                @tekojo said:

                At least make a list of what it would require.

                Sorry, but I'm not a server guy. I have zero experience in setting up webservers/wikis :-(

                T 1 Reply Last reply 13 May 2015, 05:15
                0
                • ? A Former User
                  12 May 2015, 17:18

                  @tekojo said:

                  At least make a list of what it would require.

                  Sorry, but I'm not a server guy. I have zero experience in setting up webservers/wikis :-(

                  T Offline
                  T Offline
                  tekojo
                  wrote on 13 May 2015, 05:15 last edited by
                  #8

                  @Wieland sorry, meant that we can take that as something we figure out next week.
                  Wasn't expecting you to make the list :)

                  ? 1 Reply Last reply 13 May 2015, 09:11
                  0
                  • T tekojo
                    13 May 2015, 05:15

                    @Wieland sorry, meant that we can take that as something we figure out next week.
                    Wasn't expecting you to make the list :)

                    ? Offline
                    ? Offline
                    A Former User
                    wrote on 13 May 2015, 09:11 last edited by
                    #9

                    @tekojo Ah, ok :-) Added it to the wiki.

                    1 Reply Last reply
                    1
                    • J Offline
                      J Offline
                      JKSH
                      Moderators
                      wrote on 18 May 2015, 12:48 last edited by
                      #10

                      @Wieland: Good points on poor user experience for non-English readers. Note that some of the issues boil down to the messy organization of the English pages themselves. For example, even I (an English native speaker) find the large list of snippets to be a poor way to present items.

                      (I'm not convinced that it's a good idea to encourage users to post small snippets, actually... but that's for a separate discussion)

                      => On the German Wikipedia each page has a German name, e.g. the "main page" is named "Hauptseite" http://de.wikipedia.org/wiki/Wikipedia:Hauptseite . On the Qt wiki it is named "Main/de". And not only doesn't the URI give a useful name to non-English speakers the big title on top of the page also says "Main/de".

                      This can currently be alleviated by using {{DISPLAYTITLE:}}. See http://wiki.qt.io/Adjust_Spacing_and_Margins_between_Widgets_in_Layout/de

                      Qt Doc Search for browsers: forum.qt.io/topic/35616/web-browser-extension-for-improved-doc-searches

                      1 Reply Last reply
                      0
                      • ? Offline
                        ? Offline
                        A Former User
                        wrote on 21 May 2015, 04:32 last edited by
                        #11

                        Hi everyone,
                        I will dedicate some time to improving the wiki today. I was just wondering what the exact purpose of the wiki is. I mean, one can't make changes to a system without knowing what it's actually good for. Is there any common sense about what belongs in the wiki and what doesn't?

                        1 Reply Last reply
                        0
                        • T Offline
                          T Offline
                          tekojo
                          wrote on 21 May 2015, 08:19 last edited by
                          #12

                          In general the wiki in Qt has been used as a place to store knowledge. In other words, anything that isn't completely static (should be on the web pages) or documentation (should be in documentation) has been put in the wiki.

                          The wiki should be a place where the community finds and stores information that changes.

                          That said, the wiki suffers from outdated information, and lack of clean structure. The front page looks fairly ok, maybe too many topics in there.
                          Another problem is with information that probably should not be on the wiki. We don't have a place to move things out of there. For example on the front page it says that code examples are not best placed in the wiki (I agree), but we don't have a canonical place for community snippets and examples. Maybe a github group would be the thing for that?

                          I didn't help much, did I.

                          ? 1 Reply Last reply 21 May 2015, 09:47
                          -1
                          • T tekojo
                            21 May 2015, 08:19

                            In general the wiki in Qt has been used as a place to store knowledge. In other words, anything that isn't completely static (should be on the web pages) or documentation (should be in documentation) has been put in the wiki.

                            The wiki should be a place where the community finds and stores information that changes.

                            That said, the wiki suffers from outdated information, and lack of clean structure. The front page looks fairly ok, maybe too many topics in there.
                            Another problem is with information that probably should not be on the wiki. We don't have a place to move things out of there. For example on the front page it says that code examples are not best placed in the wiki (I agree), but we don't have a canonical place for community snippets and examples. Maybe a github group would be the thing for that?

                            I didn't help much, did I.

                            ? Offline
                            ? Offline
                            A Former User
                            wrote on 21 May 2015, 09:47 last edited by
                            #13

                            @tekojo Thanks! To be a bit more specific: For example, the main page shows a table with Qt releases. Should this really be there?
                            You said: "anything not completely static or documentation" and ideally not snippets and examples. So, what is left? Tutorial articles? Something like book chapters? Or is the wiki just the place to dump everything that has no other place? (Sorry if this is a silly question, but I don't want to invest time without knowing what the wiki should actually look like.)

                            J 1 Reply Last reply 21 May 2015, 16:01
                            0
                            • T Offline
                              T Offline
                              tekojo
                              wrote on 21 May 2015, 13:05 last edited by
                              #14

                              Not a stupid question at all.

                              Maybe a good approach is that taken in fantasy/scifi worlds. There is canon (in our case documentation and project code) and things that are either not yet canonised or will not be canon, but are important. The wiki should be the place for the later. A lot of material is needed to explain Qt, and the wiki is the place for that.

                              This brings in the problem of how the wiki should be organised. I like the front page for being organised around things that you might do. That is a good approach, it makes finding things simpler. However too many items on a page make it harder to read and find things.

                              The release table appeared there a couple of days back. It makes sense to have one (we didn't previously). But probably it should be a page with a link to it from the main page. With the link probably under developing Qt.

                              1 Reply Last reply
                              0
                              • ? A Former User
                                21 May 2015, 09:47

                                @tekojo Thanks! To be a bit more specific: For example, the main page shows a table with Qt releases. Should this really be there?
                                You said: "anything not completely static or documentation" and ideally not snippets and examples. So, what is left? Tutorial articles? Something like book chapters? Or is the wiki just the place to dump everything that has no other place? (Sorry if this is a silly question, but I don't want to invest time without knowing what the wiki should actually look like.)

                                J Offline
                                J Offline
                                JKSH
                                Moderators
                                wrote on 21 May 2015, 16:01 last edited by JKSH
                                #15

                                @Wieland said:

                                For example, the main page shows a table with Qt releases. Should this really be there?

                                @tekojo said:

                                The release table appeared there a couple of days back. It makes sense to have one (we didn't previously). But probably it should be a page with a link to it from the main page. With the link probably under developing Qt.

                                I added that table a few days ago, but didn't intend for the full table to be on the front page for long. (I didn't want to spend time creating an additional brief table then, and I was also being sneaky in trying to increase its visibility this way.)

                                I quite like how Ubuntu has presented their release info:

                                • Main page with small table: https://wiki.ubuntu.com/Home
                                • Detailed tables: https://wiki.ubuntu.com/Releases

                                Would you be willing to polish that, @Wieland?

                                A lot of material is needed to explain Qt, and the wiki is the place for that.

                                I was thinking about the history of Qt. There's a very nice but very brief overview at http://qt.io/qt20 -- it would be great to expand on that. It doesn't belong in official documentation (especially the parts about old versions), but would be right at home in the wiki.

                                This brings in the problem of how the wiki should be organised. I like the front page for being organised around things that you might do. That is a good approach, it makes finding things simpler. However too many items on a page make it harder to read and find things.

                                Agreed.

                                I think the following would be helpful for the main page:

                                • Make the Release Info table briefer, move the full table elsewhere (and expand it -- it's not complete yet)
                                • Move less important links into their "Overview" pages to declutter the main page
                                • Use boxes and icons for visual grouping (I find a long hierarchical list hard to read)

                                Related to organization, we also need to overhaul the Categories system. There are too many single-member categories.

                                Qt Doc Search for browsers: forum.qt.io/topic/35616/web-browser-extension-for-improved-doc-searches

                                ? 2 Replies Last reply 21 May 2015, 16:18
                                1
                                • J JKSH
                                  21 May 2015, 16:01

                                  @Wieland said:

                                  For example, the main page shows a table with Qt releases. Should this really be there?

                                  @tekojo said:

                                  The release table appeared there a couple of days back. It makes sense to have one (we didn't previously). But probably it should be a page with a link to it from the main page. With the link probably under developing Qt.

                                  I added that table a few days ago, but didn't intend for the full table to be on the front page for long. (I didn't want to spend time creating an additional brief table then, and I was also being sneaky in trying to increase its visibility this way.)

                                  I quite like how Ubuntu has presented their release info:

                                  • Main page with small table: https://wiki.ubuntu.com/Home
                                  • Detailed tables: https://wiki.ubuntu.com/Releases

                                  Would you be willing to polish that, @Wieland?

                                  A lot of material is needed to explain Qt, and the wiki is the place for that.

                                  I was thinking about the history of Qt. There's a very nice but very brief overview at http://qt.io/qt20 -- it would be great to expand on that. It doesn't belong in official documentation (especially the parts about old versions), but would be right at home in the wiki.

                                  This brings in the problem of how the wiki should be organised. I like the front page for being organised around things that you might do. That is a good approach, it makes finding things simpler. However too many items on a page make it harder to read and find things.

                                  Agreed.

                                  I think the following would be helpful for the main page:

                                  • Make the Release Info table briefer, move the full table elsewhere (and expand it -- it's not complete yet)
                                  • Move less important links into their "Overview" pages to declutter the main page
                                  • Use boxes and icons for visual grouping (I find a long hierarchical list hard to read)

                                  Related to organization, we also need to overhaul the Categories system. There are too many single-member categories.

                                  ? Offline
                                  ? Offline
                                  A Former User
                                  wrote on 21 May 2015, 16:18 last edited by
                                  #16

                                  @JKSH Valid points.

                                  Would you be willing to polish that

                                  Sure! :-)

                                  1 Reply Last reply
                                  4
                                  • ? Offline
                                    ? Offline
                                    A Former User
                                    wrote on 22 May 2015, 03:45 last edited by
                                    #17

                                    Hello everyone,

                                    I've made some changes to the main page. I haven't actually deleted anything but mostly created a handful of new pages and moved stuff there. Of course it's far from being complete but I think one can get an idea of what my intentions are. I would be happy to get some feedback from you before I go on.

                                    Cheers!

                                    J 1 Reply Last reply 23 May 2015, 02:40
                                    3
                                    • S Offline
                                      S Offline
                                      SGaist
                                      Lifetime Qt Champion
                                      wrote on 22 May 2015, 21:21 last edited by
                                      #18

                                      Looks good, easier to read than before

                                      Interested in AI ? www.idiap.ch
                                      Please read the Qt Code of Conduct - https://forum.qt.io/topic/113070/qt-code-of-conduct

                                      1 Reply Last reply
                                      0
                                      • ? A Former User
                                        22 May 2015, 03:45

                                        Hello everyone,

                                        I've made some changes to the main page. I haven't actually deleted anything but mostly created a handful of new pages and moved stuff there. Of course it's far from being complete but I think one can get an idea of what my intentions are. I would be happy to get some feedback from you before I go on.

                                        Cheers!

                                        J Offline
                                        J Offline
                                        JKSH
                                        Moderators
                                        wrote on 23 May 2015, 02:40 last edited by
                                        #19

                                        @Wieland said:

                                        Hello everyone,

                                        I've made some changes to the main page. I haven't actually deleted anything but mostly created a handful of new pages and moved stuff there. Of course it's far from being complete but I think one can get an idea of what my intentions are. I would be happy to get some feedback from you before I go on.

                                        Cheers!

                                        It's much tidier than before. I like it! Thanks!

                                        Qt Doc Search for browsers: forum.qt.io/topic/35616/web-browser-extension-for-improved-doc-searches

                                        1 Reply Last reply
                                        1
                                        • ? Offline
                                          ? Offline
                                          A Former User
                                          wrote on 23 May 2015, 03:48 last edited by A Former User
                                          #20

                                          Hi guys!

                                          I'm currently gathering information needed to improve the "Supported Platforms" page. By now it is more or less repeating what is already stated here and here. I would like to add some info that is hard to find elsewhere and I need some help: What platforms is Qt known to work on that are not supported either by The Qt Company or the community? E.g. I know that one can use it on FreeBSD. What else do we have? What about the other *BSDs, OpenIndiana, Haiku? What about VxWorks? VxWorks runs on all industrial robots made by Kuka (very big market share). And it drives the NASA mars rovers. Another thing is gaming consoles: Are there any for that one can write games with Qt? What about stuff like home automation, car entertainment systems, machine tools or process automation?

                                          Cheers!

                                          J 1 Reply Last reply 23 May 2015, 04:52
                                          1

                                          10/31

                                          18 May 2015, 12:48

                                          topic:navigator.unread, 21
                                          • Login

                                          • Login or register to search.
                                          10 out of 31
                                          • First post
                                            10/31
                                            Last post
                                          0
                                          • Categories
                                          • Recent
                                          • Tags
                                          • Popular
                                          • Users
                                          • Groups
                                          • Search
                                          • Get Qt Extensions
                                          • Unsolved