TMC is an independent, primarily volunteer organization that relies on ad revenue to cover its operating costs. Please consider whitelisting TMC on your ad blocker or making a Paypal contribution here: paypal.me/SupportTMC

Time to start a Model S Wiki Manual?

Discussion in 'Model S' started by thedonald, Dec 22, 2012.

  1. thedonald

    thedonald Member

    Joined:
    Apr 5, 2012
    Messages:
    17
    Location:
    Northern California
    Perhaps its time to start a Wiki based Model S manual. With the car's changing feature set, a Wiki manual makes more sense. Any takers on the effort?
     
  2. alset

    alset Member

    Joined:
    Sep 7, 2012
    Messages:
    139
    Location:
    Boston
    I totally agree, too hard to catch-up/keep up with posts. I can contribute - maybe someone can start an outline and we can sign folks up for sub-sections?
     
  3. Owner

    Owner Active Member

    Joined:
    Dec 20, 2012
    Messages:
    1,230
    Location:
    San Francisco Bay Area
    I think this is a good idea. Tesla's documentation was not their strong point with the Roadster.
    Part of my blog, Tesla Owner, ended up being some details about some features I discovered.
    But I do like the idea of a user based manual is an interesting idea. I'd assume Tesla itself would put more effort into the manual and have it eventually be part of the touch screen. Seems like it might be somewhat of a duplication of effort.
    What exactly is your vision of this? I'd be interested in helping if the vision made sense and was an adjunct to the standard manual.
     
  4. FlasherZ

    FlasherZ Sig Model S + Sig Model X + Model 3 Resv

    Joined:
    Jun 21, 2012
    Messages:
    7,019
    You would really need a single benevolent leader to lead the effort, as communities rarely self-organize something like documentation very well.
     
  5. jerry33

    jerry33 S85 - VIN:P05130 - 3/2/13

    Joined:
    Mar 8, 2012
    Messages:
    12,756
    Location:
    Texas
    +1. I've never had much luck finding things in wikis, so mostly I just ignore them.
     
  6. Francis Lau

    Francis Lau P-1456

    Joined:
    May 27, 2012
    Messages:
    514
    Location:
    Bellevue, WA
    I can help lead the charge if we can have topics leaders help create and maintain the content. I have a server hosting a Confluence wiki and I could try to get a community license to host the wiki. I can create the outline for topics and then have a small group of contributors. I certainly do not have sufficient knowledge to be the author for almost all topics :). We can get a domain so it is easy to access. My tech writing and training teams use this product as well - you can see an example at http://docs.marketleader.com. It has a great interface supporting full text search, images, embedded videos, embedded presentations, open source widgets etc. I can get my designer to create a brand so it looks nicer.

    Is this what you all are thinking? I tried to buy the domain Teslapedia.com but it is sold :( Maybe we can find another.

    - - - Updated - - -

    Confluence uses Lucene for full text searches so it works pretty well. But it also depends on how well we use the correct keywords in the articles
     
  7. Francis Lau

    Francis Lau P-1456

    Joined:
    May 27, 2012
    Messages:
    514
    Location:
    Bellevue, WA
    I just bought the TeslaWiki.com domain, what do folks think about this approach before I plunge right in?
    * Domain: http://www.TeslaWiki.com
    * Setup with Confluence wiki product hosted by me
    * I create initial home page and site map for topics
    * Community review
    * Find topic leaders and authors
    * Publicize
    * Use, improve and add content
     
  8. thedonald

    thedonald Member

    Joined:
    Apr 5, 2012
    Messages:
    17
    Location:
    Northern California
    I'm thinking that some topics are better served by a wiki--like the list of features in each software update. What is important is that it fits in with Tesla Motors Club, not detract from it or compete with it. So I'm thinking we use the wiki on Tesla Motors Club. We start with a single topic which could use documenting/tips and see how that goes.
     
  9. dsm363

    dsm363 Roadster + Sig Model S

    Joined:
    May 17, 2009
    Messages:
    18,235
    Location:
    Las Vegas, NV
  10. AndyM

    AndyM Member

    Joined:
    Apr 10, 2012
    Messages:
    661
    Location:
    Sherwood, OR, USA
    While it's not in Wiki format, I have collected a lot of this data already from many places, not just the forums here.
    It's a GoogleDocs spreadsheet. If someone would like to spend the time to import that data into a new format, please be my guest. I just haven't had the time to do that.
    See my sig below for the link to the Google spreadsheet.
     
  11. thedonald

    thedonald Member

    Joined:
    Apr 5, 2012
    Messages:
    17
    Location:
    Northern California
    I think what's needed is not a "Manual" but instead a Tips section of the wiki. This section would be populated with the results of threads once a course of action/consensus has been determined. This way, there is an easier way to locate the final "tip". Since this is a wiki--just a series of linked pages, it would be easy to re-organize the wiki as needed.
     
  12. bonnie

    bonnie Oil is for sissies.

    Joined:
    Feb 6, 2011
    Messages:
    14,241
    Location:
    Columbia River Gorge
    Why wouldn't you just use the TMC wiki setup? Why a new domain?
     
  13. brianman

    brianman Burrito Founder

    Joined:
    Nov 10, 2011
    Messages:
    15,487
    Presumably because there are limits to who can create wikis on TMC. Put another way, the TMC implementation is currently more like a small number of moderator-created set of wiki pages rather than a wiki site where topics are relatively short, narrow in topic, and heavily cross-linked.

    For example, lol's (I forgot his full forum nick, sorry) proposal for an issues thread could just be collated as a wiki by him or multiple people on a general wiki quickly and easily. As it stands with TMC, a mod would have to create the topic (and any subtopics linked to) which introduces an overhead factor that makes it not worth the effort.

    This post is not intended as a complaint, just an evaluation.

    Update:
    Skimming some of the newer content in the Wiki area, perhaps some of the permissions have been opend up since I last looked. If so, that may invalidate some of the "outsourcing" rationale suggested above.
     
  14. bonnie

    bonnie Oil is for sissies.

    Joined:
    Feb 6, 2011
    Messages:
    14,241
    Location:
    Columbia River Gorge
    The TMC wiki pages are set up so that anyone can edit.
     
  15. brianman

    brianman Burrito Founder

    Joined:
    Nov 10, 2011
    Messages:
    15,487
    Are they currently set up so that anyone can create a topic? Originally they were not.
     
  16. Francis Lau

    Francis Lau P-1456

    Joined:
    May 27, 2012
    Messages:
    514
    Location:
    Bellevue, WA
    Then main reason is that a full fledge wiki product offers much more functionality; especially to lay out information in a more intuitive manner. However, I agree with the need to not compete with the TMC domain. Maybe we can go with a subdomain like wiki.teslamotorsclub.com. I will create an outline of the site to show what the advantages are. It will take me a week or so since I am busy this week.
     
  17. bonnie

    bonnie Oil is for sissies.

    Joined:
    Feb 6, 2011
    Messages:
    14,241
    Location:
    Columbia River Gorge
    PM sent. :) Thanks, Francis.
     
  18. thedonald

    thedonald Member

    Joined:
    Apr 5, 2012
    Messages:
    17
    Location:
    Northern California
    #18 thedonald, Jan 7, 2013
    Last edited: Jan 8, 2013
    I was playing with the TMC test wiki and could not figure out how to create a new page which I could link from the test page. There is a way to link to a page, but not a clear way to create a new sub page.
     

Share This Page