Difference between revisions of "Talk:Style Guide"

From Second Life Wiki
Jump to navigation Jump to search
(→‎Template:KeyCombo: new section)
Line 31: Line 31:
::Oh, @changing [[Template:KeyCombo]] one by one: I think it would be a similar search & replace algorithm like the one you're using to replace the HTML syntax with wiki syntax. Once the algorithm finds something like CTRL-ALT-SHIFT-H, it should replace it with <nowiki>{{KeyCombo|ctrl=*|alt=*|shift=*|H}}</nowiki>. though I can't tell how to implement it exactly, since I don't know what you're using there. But changing it by hand wouldn't take so long either... We need to check each new article for proper conversion anyway.
::Oh, @changing [[Template:KeyCombo]] one by one: I think it would be a similar search & replace algorithm like the one you're using to replace the HTML syntax with wiki syntax. Once the algorithm finds something like CTRL-ALT-SHIFT-H, it should replace it with <nowiki>{{KeyCombo|ctrl=*|alt=*|shift=*|H}}</nowiki>. though I can't tell how to implement it exactly, since I don't know what you're using there. But changing it by hand wouldn't take so long either... We need to check each new article for proper conversion anyway.
::--[[Image:Zai_signature.png|45px]] '''[[User:Zai Lynch|Lynch]]''' <sup><small>([[User talk:Zai Lynch|talk]]|[[Special:Contributions/Zai Lynch|contribs]])</small></sup> 14:15, 13 June 2009 (UTC)
::--[[Image:Zai_signature.png|45px]] '''[[User:Zai Lynch|Lynch]]''' <sup><small>([[User talk:Zai Lynch|talk]]|[[Special:Contributions/Zai Lynch|contribs]])</small></sup> 14:15, 13 June 2009 (UTC)
:In the context of the LSL Portal, we have stricken the term Agent. While the distinction between Avatar and Agent is important, it confuses people none the less and is a categorization nightmare. The best part about this, I don't think anyone has noticed. -- '''[[User:Strife_Onizuka|Strife]]''' <sup><small>([[User talk:Strife_Onizuka|talk]]|[[Special:Contributions/Strife_Onizuka|contribs]])</small></sup> 17:55, 13 June 2009 (UTC)


== [[Template:KeyCombo]] ==
== [[Template:KeyCombo]] ==

Revision as of 10:55, 13 June 2009

Feedback

First of all: This seems to be a pretty good start! Now the actual feedback:

  • In Style guide#Expired terminology, you mention that we should use "Residents" instead of "users", "subscribers", "customers", "avatars", etc.. I would like to strike "avatars" in this context. While "Resident", "user", "subscriber" and "customer" might be used synonymously, an avatar is something completly different and shouldn't be confused with the others (not even in this style guide). The use of the term "avatar" in a KB article should be allowed where appropriate - at the point where we're referring to one physical representation of a Resident inworld. For example at an article like "How can I change my appearance?" or something similar.
  • The style guide as such should be named as what it is (like "Style guide for Knowledge Base articles") and moved to either the Help: or the Project: namespace. It also might be tagged with {{Help|Wiki=*}}.
  • The guide gives advice to set links where appropriate. Once the KB is moved to the wiki, we'll basically have two help resources. The KB and the Help Portal. This isn't ideal. The question is: should these be distinguished or merged? I'd like to go with "merged". In case the answer is "ditinguished", then we'll need a guideline when links from one resource to another are allowed and how to mark them (in case they need to be marked). For example, you're giving the advice to link to glossary items, which are part of the Help Portal / not "verified". I can see that there will be quite some work to verify that the Help Portal articles are up-to-date and accurate, though over time, it might become quite hard to keep them distinguished anyway. So merging them from the start seems to be a good way to go.
  • I'm not sure why you mention that the use of Template:KeyCombo should be refused. Is it because the viewer uses minus signs instead of plus signs? You can also use Template:Keypress for single keys or make a specific Template:KeyComboKB which uses minus signs instead of plus signs and which becomes redirected to Template:KeyCombo once the dispute is settled?
  • I'd recommend to use {{L$}} (which results in L$) instead of L$ (nice hovertext).

err... I think there was more that I wanted to mention though it's quite late and I'm pretty tired. Maybe I'll remember more tomorrow. Nite and thx for the guide! :-)
--Zai signature.png Lynch (talk|contribs) 00:40, 12 June 2009 (UTC)

Response!

Zai! THANKS for your sharp insights as always.

Quick version: all great ideas, some of them may not be done yet but should be considered.

Details:

  • Yes, we absolutely do consider that "avatars" should be used whenever appropriate. We'll clarify that soon after I chat with my team (just wanted to reply to you quickly).
  • Also agree that's a better place to move this page!
  • Merging the two resources is a possible future if the KB2Wiki Pilot succeeds. It's one of those "We can see it happening, but other stuff needs to happen first" — in any case, important to prepare for that possibility now.
  • Template:KeyCombo is not refused, but is another one of those "likely later, but not yet" things because we don't have an easy way to automate all the conversions from their KB source pages. (And might have to end up changing them one-by-one.) Any ideas here?
  • Also agree about using Wiki-specific features which make it easier to glossary stuff — L$ is a great example and we'll be making more allowance for that. I bet there'll be lots of opportunities to spot many tweaks.
- Torley-favicon.png Torley on 2009-06-13 @ 6:25 AM PST
OK, will try to be patient and cross fingers that the move will succeed :-)
--Zai signature.png Lynch (talk|contribs) 14:02, 13 June 2009 (UTC)
Oh, @changing Template:KeyCombo one by one: I think it would be a similar search & replace algorithm like the one you're using to replace the HTML syntax with wiki syntax. Once the algorithm finds something like CTRL-ALT-SHIFT-H, it should replace it with {{KeyCombo|ctrl=*|alt=*|shift=*|H}}. though I can't tell how to implement it exactly, since I don't know what you're using there. But changing it by hand wouldn't take so long either... We need to check each new article for proper conversion anyway.
--Zai signature.png Lynch (talk|contribs) 14:15, 13 June 2009 (UTC)
In the context of the LSL Portal, we have stricken the term Agent. While the distinction between Avatar and Agent is important, it confuses people none the less and is a categorization nightmare. The best part about this, I don't think anyone has noticed. -- Strife (talk|contribs) 17:55, 13 June 2009 (UTC)

Template:KeyCombo

Torley said: "Template:KeyCombo is not refused, but is another one of those "likely later, but not yet" things because we don't have an easy way to automate all the conversions from their KB source pages. (And might have to end up changing them one-by-one.) Any ideas here? "

An automatic conversion sounds like a task for someone with awk or sed skills. However, I think it would also be acceptable to do a manual conversion, even if both styles will be around during the transition. In my opinion, to retain the professional appearance, the following should be sufficiant:
  • It should only be this two styles; don't invent any new ones.
  • Don't mix the two styles in the same article. Convert an article as a whole or not at all.
    • As KB articles don't tend to be too long, this should be doable.
Also, the style guide should state which one is preferred for new articles.
--Boroondas Gupte 15:07, 13 June 2009 (UTC)