2014-10-28, 23:56
How will changing XBMC to Kodi be handled in the wiki? Should contributors start changing this?
2014-10-29, 21:33
It's a bit tricky, since I'd like the documentation to still be easy to understand for the current v13 builds, even for a little bit after v14 is released.
This is what I've been currently doing:
If you're ever not sure how to go about updating the name, feel free to ask me or even just take your best guess. The great thing about a wiki is that everyone is able to see the changes and can double check each other.
This is what I've been currently doing:
- In many places we are using a template that you just type as {{kodi}}, which pastes the text "XBMC/Kodi", to refer to both names. The template will be easy to update so that everyplace where {{kodi}} is typed can be updated at once.
- The template has been updated to just say "Kodi", so we can just write that directly now. There might still be places where it is good to write both names, so using "Kodi/XBMC" or "Kodi, formerly known as XBMC, ..." would be okay in the intro section of that page.
- The template has been updated to just say "Kodi", so we can just write that directly now. There might still be places where it is good to write both names, so using "Kodi/XBMC" or "Kodi, formerly known as XBMC, ..." would be okay in the intro section of that page.
- Sometimes the name "XBMC" can be removed completely and something will still make sense. For example, "Go into XBMC's video settings" can just be replaced with "go into the video settings", since we're normally just talking about XBMC/Kodi itself and not another program.
- Places where exact file paths or links or other exact instructions are used, it's good to just show a note about the future rename. For example, the userdata (wiki) page says that the XBMC directory will be renamed as Kodi in the future. That same note is transcluded on many other pages that reference the userdata folder path. Once Kodi is released we will still have a note there, but it will be past-tense and say something like "the Kodi directory was named "XBMC" in past versions".
- Brand new features for v14 can be just written as Kodi, since they technically don't exist under any stable "XBMC" release.
- Refernces to old versions don't have to be updated or removed. For example, saying "this was added in XBMC v12" is okay, because that was what the program was called for v12.
If you're ever not sure how to go about updating the name, feel free to ask me or even just take your best guess. The great thing about a wiki is that everyone is able to see the changes and can double check each other.
