Wiki Hackaton
- matt3o
- -[°_°]-
- Location: Italy
- Main keyboard: WhiteFox
- Main mouse: Anywhere MX
- Favorite switch: Anything, really
- DT Pro Member: 0030
- Contact:
I believe we need to work a little on the wiki. It's a great resource and it deserves better.
There are really too many drafts and stubs. Some info is badly structured and/or categorized. There's no uniformity in language (UK/US), measurements, currencies, prices, etc.
I also feel some sections are redundant or impossible to maintain (group buys).
The "Guides" are nice resources but they all need work and that "draft document" removed. Imho some data also needs to go (like "$$ value" in some keyboards).
The homepage needs some thoughts too with a better presentation of the content.
My idea would be to start talking here about all the required work, define clear standards and nice templates and then run a sort of "hackaton month" to give new energy to the wiki.
We could possibly add prizes to spice it up, both for random and top contributors.
Please share your ideas, suggestions, opinions!
There are really too many drafts and stubs. Some info is badly structured and/or categorized. There's no uniformity in language (UK/US), measurements, currencies, prices, etc.
I also feel some sections are redundant or impossible to maintain (group buys).
The "Guides" are nice resources but they all need work and that "draft document" removed. Imho some data also needs to go (like "$$ value" in some keyboards).
The homepage needs some thoughts too with a better presentation of the content.
My idea would be to start talking here about all the required work, define clear standards and nice templates and then run a sort of "hackaton month" to give new energy to the wiki.
We could possibly add prizes to spice it up, both for random and top contributors.
Please share your ideas, suggestions, opinions!
- TheInverseKey
- Location: Great White North
- Main mouse: M570
- Favorite switch: Hi-Tek 725 Linear
- DT Pro Member: 0216
- Contact:
As I am now adding a lot more to the Wiki here are some things that I came across:
- Standardized page layout for each board or version
- Reorganized categories that have duplicated data/entries
- Add converter section in standard page layout
- Add Todo section of information that is missing from pages
- Myoth
- Location: Strasbourg
- Main keyboard: IDB60
- Main mouse: EC1-A
- Favorite switch: Cap BS
- DT Pro Member: -
- re-organize the fuck out of overlapping pages, mainly keyboard series (the Alps bigfoot one is a mess)
- template for certain typical pages like keyboard, switch
- upgrade somehow the uploader, it's a PITA to use and isn't noob-friendly IMO
-
- Location: Stockholm, Sweden
- DT Pro Member: 0011
Sometimes a stub is better than no mention at all. You could come across something you didn't know exist and search for more information on your own.
For instance, Enthusiast vendors is a category where just getting the name or URL of a company to check out could be valuable.
Template:Infobox dkeyboard has "price".
That is not supposed to be current value, but supposed to be MSRP on launch. It could serve a rough indicator of whether it was an expensive or cheap keyboard at the time.
Myself, I enter whatever currency I can find when I write the page, and that is often either $ or €. I think no other currency should be entered.
It does not hurt to keep it, but documentation about it is lacking. And yes, the field should have had a more fitting name to begin with but it is too late.
When discussing this a few years ago, we came to the consensus that an article could be in either but that we should attempt to not have both in the same article.
Myself, I try to use British English, because ... we are in Europe.
Edit: The Wiki does have among its HTTP headers "content-language: en-GB".
Many computers systems are set to US English by default though (if not as default, then as its default English after another primary language setting).
I believe web browsers used to set language for spelling-correction automatically to language in the HTTP header, but I am not sure if all major browsers still honour that.
What do you mean exactly?
There are some articles for keyboards and switches where multiple variations are listed in the same article, but each variation has a redirect page to that article.
Here there would be some duplicity where both a redirect and the main article are in a category.
Ideally, we would want only the redirect to be in each category's list but we still want the article itself to have links to each category — but that is not how categories work. People navigate only to redirects, never from them.
I don't have a good solution to that. Do you have a suggestion?
Or did you mean something else?
Please link to an example.
The TODO tag has been used for that. But can it be edited in the visual editor?
- TheInverseKey
- Location: Great White North
- Main mouse: M570
- Favorite switch: Hi-Tek 725 Linear
- DT Pro Member: 0216
- Contact:
Look at the RT101 sections they are a mess and need to be consolidated. Personally, I think each model should have it's own page.Findecanor wrote: ↑01 Feb 2019, 22:11What do you mean exactly?
There are some articles for keyboards and switches where multiple variations are listed in the same article, but each variation has a redirect page to that article.
Here there would be some duplicity where both a redirect and the main article are in a category.
Ideally, we would want only the redirect to be in each category's list but we still want the article itself to have links to each category — but that is not how categories work. People navigate only to redirects, never from them.
I don't have a good solution to that. Do you have a suggestion?
Or did you mean something else?
Please link to an example.
wiki/Category:Keyboards_with_NMB_switches
No it cannot be edited in the visual editor only source.TheInverseKey wrote: ↑01 Feb 2019, 20:13
- Add Todo section of information that is missing from pages
Findecanor wrote: ↑01 Feb 2019, 22:11The TODO tag has been used for that. But can it be edited in the visual editor?
-
- Location: Stockholm, Sweden
- DT Pro Member: 0011
Indeed those pages are a mess, but only someone who knows specifically about NMB keyboard models could straighten that out...TheInverseKey wrote: ↑01 Feb 2019, 22:26Look at the RT101 sections they are a mess and need to be consolidated. Personally, I think each model should have it's own page.
wiki/Category:Keyboards_with_NMB_switches
Ideally, each keyboard should have its own article, but before anyone has written a page, it should have its own redirect.
No it cannot be edited in the visual editor only source.TheInverseKey wrote: ↑01 Feb 2019, 20:13
- Add Todo section of information that is missing from pages
Findecanor wrote: ↑01 Feb 2019, 22:11The TODO tag has been used for that. But can it be edited in the visual editor?
[/quote]
I checked myself now. "TODO photo" can be edited or deleted, but not added...
The benefit of having it as a tag is that it automatically adds the page to a category of pages that require additional work.
Maybe the different TODO tags could be added to the visual editor's tool bar somewhere.
- matt3o
- -[°_°]-
- Location: Italy
- Main keyboard: WhiteFox
- Main mouse: Anywhere MX
- Favorite switch: Anything, really
- DT Pro Member: 0030
- Contact:
stubs are fine, would be nice to expand them anyway.
The value of the keyboard is a field that has no sense. It is hard to establish and harder to keep updated. The cost of the keyboard when it was released is an important parameter on the other hand.
All 7bit group buys need to be organized in multiple pages because they are killing the server.
Most of the guides need review.
I also saw many dead external links, that is natural, but maybe we could by default link to internet archive.
Many topics could be organized in sub-pages/categories while I feel sometimes there are too many (brands > Sunrex > Sunrex OEM > ...).
Sometimes I see what seems duplicated categories. Like
Maybe it is used internally for different kind of lists, I haven't checked honestly, and it's not actually a big deal.
We also have some duplicate contents that need to be consolidated (eg: Novelty and Artisan keycaps).
I see a lot of work to do. I don't even know where to start from![Very Happy :D](./images/smilies/icon_e_biggrin.gif)
The value of the keyboard is a field that has no sense. It is hard to establish and harder to keep updated. The cost of the keyboard when it was released is an important parameter on the other hand.
All 7bit group buys need to be organized in multiple pages because they are killing the server.
Most of the guides need review.
I also saw many dead external links, that is natural, but maybe we could by default link to internet archive.
Many topics could be organized in sub-pages/categories while I feel sometimes there are too many (brands > Sunrex > Sunrex OEM > ...).
Sometimes I see what seems duplicated categories. Like
Code: Select all
[[Category:NMB keyboards]]
[[Category:Keyboards with NMB switches]]
We also have some duplicate contents that need to be consolidated (eg: Novelty and Artisan keycaps).
I see a lot of work to do. I don't even know where to start from
![Very Happy :D](./images/smilies/icon_e_biggrin.gif)
- Muirium
- µ
- Location: Edinburgh, Scotland
- Main keyboard: HHKB Type-S with Bluetooth by Hasu
- Main mouse: Apple Magic Mouse
- Favorite switch: Gotta Try 'Em All
- DT Pro Member: µ
Original price and “modern” price at a specified date are quite worth having, I think. Have them in the template but make them well behaved if left blank. Some boards started with similar prices and wound up very differently prized. And even a decade out of date value will tell you something if it’s the first time you’ve ever looked one up, so long as it is dated.
The idea of using English English for wiki pages but enforcing USD or EUR for values does of course amuse me!
My real trouble with wikis is that I can’t sensibly contribute to them. My recall is always vague on specifics and better suited to stories, especially with jokes along the way. I am Non Neutral Point of View personified, implying things left right and centre without even realising that’s what I’m saying, even if (I think) they’re right. A good part of my communication style is Unknown Knowns…
The idea of using English English for wiki pages but enforcing USD or EUR for values does of course amuse me!
My real trouble with wikis is that I can’t sensibly contribute to them. My recall is always vague on specifics and better suited to stories, especially with jokes along the way. I am Non Neutral Point of View personified, implying things left right and centre without even realising that’s what I’m saying, even if (I think) they’re right. A good part of my communication style is Unknown Knowns…
- matt3o
- -[°_°]-
- Location: Italy
- Main keyboard: WhiteFox
- Main mouse: Anywhere MX
- Favorite switch: Anything, really
- DT Pro Member: 0030
- Contact:
it a value impossible to maintain and also very hard to find. I see people buying standard Model M at $100+ on ebay while I find them free at the local junkyard.
Most keyboards even from China/Taiwan are listed in USD so it's generally easier to find the USD value. Probably the best would be to just use the currency of the originating country. Like for Topre would be Yen, for GMK Euro, the vast majority would be USD.
- TheInverseKey
- Location: Great White North
- Main mouse: M570
- Favorite switch: Hi-Tek 725 Linear
- DT Pro Member: 0216
- Contact:
I checked myself now. "TODO photo" can be edited or deleted, but not added...Findecanor wrote: ↑01 Feb 2019, 22:42Indeed those pages are a mess, but only someone who knows specifically about NMB keyboard models could straighten that out...TheInverseKey wrote: ↑01 Feb 2019, 22:26Look at the RT101 sections they are a mess and need to be consolidated. Personally, I think each model should have it's own page.
wiki/Category:Keyboards_with_NMB_switches
Ideally, each keyboard should have its own article, but before anyone has written a page, it should have its own redirect.
No it cannot be edited in the visual editor only source.
The benefit of having it as a tag is that it automatically adds the page to a category of pages that require additional work.
Maybe the different TODO tags could be added to the visual editor's tool bar somewhere.
I will take on the task hopefully soon. Just wanted to point it out and make sure that we had an example of something that needs to be consolidated.
-
- Location: land of the rusty beamsprings
- DT Pro Member: -
[[Category:Symbolics keyboards]] with [[Category:Keyboards with NMB switches]]matt3o wrote: ↑02 Feb 2019, 09:23
Sometimes I see what seems duplicated categories. Like
Maybe it is used internally for different kind of lists, I haven't checked honestly, and it's not actually a big deal.Code: Select all
[[Category:NMB keyboards]] [[Category:Keyboards with NMB switches]]
wiki/Symbolics_365407
[[Category:NMB keyboards]] with [[Category:Keyboards with NMB switches]]
wiki/NMB_RT-100/RT-8200_series
Sometimes the categories are in other categories as well:
wiki/Cherry_G80-1000: [[Category:Cherry_G80_series]] => [[Category:Cherry_keyboards]]
If you want that tree collapsed, you just look for [[Category:List of all Cherry keyboards]]
wiki/Chyron_Duet: [[Category:Keyboards with Cherry MX Clear switches]] => [[Category:Keyboards with Cherry MX switches]] => [[Category:Keyboards with Cherry switches]]
That last one is maybe a bit overkill, the Chyron Duet is the only keyboard in that category. And there is no corresponding [[Category:List of all Keyboards with Cherry switches]].
And then there is also the distinction between brand an OEM:
wiki/Xerox_Star_low-profile_keyboard is [[Category:Xerox keyboards]] and [[Category:Cherry OEM keyboards]]
-
- Location: Stockholm, Sweden
- DT Pro Member: 0011
I do think that lists with collapsed trees is a bit overkill, and that we should avoid creating new ones.
There are more keyboards than Chyron Duet that came only in Cherry MX Clear (as far as people know), but I think subcategorising "Keyboards with Cherry MX switches" may have been a bit unnecessary in the first place.
There are more keyboards than Chyron Duet that came only in Cherry MX Clear (as far as people know), but I think subcategorising "Keyboards with Cherry MX switches" may have been a bit unnecessary in the first place.
- TheInverseKey
- Location: Great White North
- Main mouse: M570
- Favorite switch: Hi-Tek 725 Linear
- DT Pro Member: 0216
- Contact:
So I just came across this while trying to edit the pictures in the gallery section.
If the gallery already exists then you don't have the ability in the visual editor to add additional pictures but rather only have the option to search for them.
Is there a way to make the visual editor upload pictures after the gallery has been created?
If the gallery already exists then you don't have the ability in the visual editor to add additional pictures but rather only have the option to search for them.
Spoiler:
- matt3o
- -[°_°]-
- Location: Italy
- Main keyboard: WhiteFox
- Main mouse: Anywhere MX
- Favorite switch: Anything, really
- DT Pro Member: 0030
- Contact:
I have to check on that, it could be just a permissions issue. I'm not very familiar with mediawiki, maybe someone more experienced could chime inTheInverseKey wrote: ↑04 Feb 2019, 23:16Is there a way to make the visual editor upload pictures after the gallery has been created?
- webwit
- Wild Duck
- Location: The Netherlands
- Main keyboard: Model F62
- Favorite switch: IBM beam spring
- DT Pro Member: 0000
- Contact:
Apparently it's just a shit gallery editor:
https://www.mediawiki.org/wiki/Help:Vis ... _galleries
https://www.mediawiki.org/wiki/Help:Vis ... _galleries
I tried that, it works, but it's not like press a button to browse for an image and add that to the gallery.The gallery editor is currently a simple box that allows you to edit existing galleries using wikitext markup. To add a new image to an existing gallery, type the file name, followed by a bar (|) and the caption for that image. You must put each image in the gallery on its own line. You can also edit this list to remove or rearrange images or to change captions.
- matt3o
- -[°_°]-
- Location: Italy
- Main keyboard: WhiteFox
- Main mouse: Anywhere MX
- Favorite switch: Anything, really
- DT Pro Member: 0030
- Contact:
sometimes it's amazing how wikipedia can run on such software
- TheInverseKey
- Location: Great White North
- Main mouse: M570
- Favorite switch: Hi-Tek 725 Linear
- DT Pro Member: 0216
- Contact:
- TheInverseKey
- Location: Great White North
- Main mouse: M570
- Favorite switch: Hi-Tek 725 Linear
- DT Pro Member: 0216
- Contact:
So if we are going to start to standardize keyboard posts on the Wiki I think that there needs to be as standard layout for a each single keyboard. Below is the code that I think should be a decent start. Please comment if you think that there should be something included in a standard layout/post.
Code: Select all
{{TODO}}
{{stub}}
{{infobox dkeyboard
| image name =
| fcc =
| pn =
| model =
| branding =
| manufacturer =
| switch =
| layouts =
| features =
| interface =
| rollover =
| weight =
}}
==Summary==
//Summary of the keyboard and it's features
==Construction==
//What is the build quality like?
==Variations==
//If there are any?
==Protocols==
//Protocols that they keyboard speaks if they are known
==Gallery==
//Pictures of the keyboard
<gallery widths=250 heights=187>
</gallery>
==Converter==
//If the keyboard needs a special converter besides XT/AT to USB. Mostly teensy related
==References==
<references />
- matt3o
- -[°_°]-
- Location: Italy
- Main keyboard: WhiteFox
- Main mouse: Anywhere MX
- Favorite switch: Anything, really
- DT Pro Member: 0030
- Contact:
what about dimensions and introductory price?
- Myoth
- Location: Strasbourg
- Main keyboard: IDB60
- Main mouse: EC1-A
- Favorite switch: Cap BS
- DT Pro Member: -
-
- Location: Stockholm, Sweden
- DT Pro Member: 0011
• Infobox fields (such as "price") are optional. If you leave one blank, it will not be displayed.
• Protocol is already covered by the "interface" field in the infobox.
• The template needs categories.
In the previous thread last year, I offered to write the templates, but matt3o stopped me because he wanted to try out a plugin (?). What happened with that?
• Protocol is already covered by the "interface" field in the infobox.
• The template needs categories.
In the previous thread last year, I offered to write the templates, but matt3o stopped me because he wanted to try out a plugin (?). What happened with that?
- matt3o
- -[°_°]-
- Location: Italy
- Main keyboard: WhiteFox
- Main mouse: Anywhere MX
- Favorite switch: Anything, really
- DT Pro Member: 0030
- Contact:
not a plugin, it's just that I had to upgrade the mediawiki first and I didn't know if something changed in the templates. Now everything is up to date. go ahead be my guest!Findecanor wrote: ↑05 Feb 2019, 13:23In the previous thread last year, I offered to write the templates, but matt3o stopped me because he wanted to try out a plugin (?). What happened with that?
- TheInverseKey
- Location: Great White North
- Main mouse: M570
- Favorite switch: Hi-Tek 725 Linear
- DT Pro Member: 0216
- Contact:
Protocol is somewhat covered by the info box but if some boards require a converter that needs to be figured out then I think that this section is appropriate.Findecanor wrote: ↑05 Feb 2019, 13:23• Infobox fields (such as "price") are optional. If you leave one blank, it will not be displayed.
• Protocol is already covered by the "interface" field in the infobox.
• The template needs categories.
In the previous thread last year, I offered to write the templates, but matt3o stopped me because he wanted to try out a plugin (?). What happened with that?
Example: wiki/ADDS_ASCII
If we could do a template that the user has to follow that would be the goal and I think it would take more investigating to get a clear answer. As for categories what do you have in mind?
-
- Location: Stockholm, Sweden
- DT Pro Member: 0011
Something else I have noticed in the Wiki is that many pages are marked as "Stub" but could be unmarked as such because they contain a reasonable amount of information.
For example, a keyboard should be in List of all keyboards, and then in:
• by brand
• by switch
• by type/property: Office/Gamer, Backlit, Tenkeyless/Compact, Vintage/Contemporary
Maybe instead of just a bare template for each common type of article, maybe it would be best to have a general help article with the template embedded inside it for the article creator to cut and paste.
Hmm. If we don't have forms, and we do have a visual editor where we can't have comments within <!-- --> then we would need a help text on the side, somehow for which types of categories that would be the most appropriate.
For example, a keyboard should be in List of all keyboards, and then in:
• by brand
• by switch
• by type/property: Office/Gamer, Backlit, Tenkeyless/Compact, Vintage/Contemporary
Maybe instead of just a bare template for each common type of article, maybe it would be best to have a general help article with the template embedded inside it for the article creator to cut and paste.
- Hypersphere
- Location: USA
- Main keyboard: Silenced & Lubed HHKB (Black)
- Main mouse: Logitech G403
- Favorite switch: Topre 45/55g Silenced; Various Alps; IBM Model F
- DT Pro Member: 0038
I think that the Wiki is (or seems to be) too difficult to use. This is deterring people from making new additions to the Wiki or editing the ones already present.
Would it be possible to make the Wiki much more user-friendly and/or to create a tutorial explaining how to make additions and revisions?
Would it be possible to make the Wiki much more user-friendly and/or to create a tutorial explaining how to make additions and revisions?
- matt3o
- -[°_°]-
- Location: Italy
- Main keyboard: WhiteFox
- Main mouse: Anywhere MX
- Favorite switch: Anything, really
- DT Pro Member: 0030
- Contact:
that is probably true, I installed the visual editor that is the best thing I could do for usability.Hypersphere wrote: ↑10 Feb 2019, 21:01I think that the Wiki is (or seems to be) too difficult to use. This is deterring people from making new additions to the Wiki or editing the ones already present.
Would it be possible to make the Wiki much more user-friendly and/or to create a tutorial explaining how to make additions and revisions?
I feel many people don't feel "adequate" and experienced enough to post updates or new pages. What I feel it really lacks is a bit of uniformity in the presentation and a good "flow" from one topic to another.
- Riceball
- Location: USA
- Main keyboard: model M
- Main mouse: Zowie EC-1 EVO
- Favorite switch: Buckling springs
- DT Pro Member: -
Not sure how hard this would be to implement, but I think it would be nice to have a "reviews" tab on the different keyboard pages. Something along the lines of what the Pentax forums does for their lens database. This way there is an organized area for more subjective thoughts on specific keyboards. It also might encourage more people to contribute as a more low pressure environment.
- TheInverseKey
- Location: Great White North
- Main mouse: M570
- Favorite switch: Hi-Tek 725 Linear
- DT Pro Member: 0216
- Contact:
It depends on what you are looking for via reviews. I think that there is enough reviews out there but most of them will be the same since a lot of keyboards share the same switches. I don't know if this is really that practical in the long run but it's a decent idea.Riceball wrote: ↑18 Feb 2020, 18:29Not sure how hard this would be to implement, but I think it would be nice to have a "reviews" tab on the different keyboard pages. Something along the lines of what the Pentax forums does for their lens database. This way there is an organized area for more subjective thoughts on specific keyboards. It also might encourage more people to contribute as a more low pressure environment.
- Riceball
- Location: USA
- Main keyboard: model M
- Main mouse: Zowie EC-1 EVO
- Favorite switch: Buckling springs
- DT Pro Member: -
I was thinking something along the lines of a 1-10 rating for something like build quality, sound, ease of convertibility, etc and a one or two line description saying something like "love it, but P.I.T.A. to convert, the feet are too tall, and the integrated trackball only works when it wants to" or "Not much information about this guy. Decent board but the feet are terrible and it slides all over my desk. Also, when you disassemble watch out for the plastic tab in the back that likes to break". Basically a quick temperature check on what people think of a specific board. I see what you mean though about many of them coming out pretty similar and the questionable practicality.TheInverseKey wrote: ↑18 Feb 2020, 20:07It depends on what you are looking for via reviews. I think that there is enough reviews out there but most of them will be the same since a lot of keyboards share the same switches. I don't know if this is really that practical in the long run but it's a decent idea.