Please upgrade here. These earlier versions are no longer being updated and have security issues.
HackerOne users: Testing against this community violates our program's Terms of Service and will result in your bounty being denied.

Vanilla developer kickstart

2

Answers

  • glad you "liked it"

    I may not provide the completed solution you might desire, but I do try to provide honest suggestions to help you solve your issue.

  • UnderDogUnderDog MVP
    edited May 2012

    6apxat said:
    I've noticed some dark spots which aren't just described anywhere:

    I love your humor!

    1) How do I know the correct event function names (e.g. DiscussionsController_AfterDiscussionTitle_Handler) to include inside my plugin?
    Where's the list of all of them?

    http://vanillawiki.homebrewforums.net/index.php?title=List_of_Functions&action=edit&redlink=1 (yes, it's an empty page, just fill the page after the list is found)

    2) A deeper understanding of the $Sender concept is needed and how to pass data between controllers.

    3) A comprehensive list of Garden functions is required (to know for example, how Gdn_Format::Url() works).

    We have 2 pages regarding functions and classes:

    Functions:

    http://vanillawiki.homebrewforums.net/index.php?title=List_of_Functions&action=edit&redlink=1

    Classes:
    http://vanillawiki.homebrewforums.net/index.php/Classes

    I think all I can say is : The VanillaWiki is all that we have. We can generate documentation from the sourcecode (phpdocumentor, doxygen?) and dump it in the Wiki, problem is it gives a lot of extra HTML which needs to be stripped first, no real converter available.

    I would love it if everyone would join the Wiki and Pitch in where he can.

    @CurtisOden Yes, please create a Wiki page with the interesting points you've listed.

    Just make up a nice page title like : Custom Theme Start Page (or something more appealing to the eyes)


    This is the link I always go to:


    http://vanillawiki.homebrewforums.net/index.php/Main_Page#The_Ultimate_Theme_Guide_for_Designers (but that's on the main page, I sense we need a special sub-page to send our users to)

    All the information on the Wiki Pages that is missing will get a red link I hope you understand what I mean by that. If not, just look at the Classes page :-) . Anyone who can fill the 'red link' pages with sensible information will be my personal hero.

    There was an error rendering this rich post.

  • qwentyqwenty New
    edited May 2012

    whu606 said:
    Have you checked through this:

    http://vanillawiki.homebrewforums.net/index.php/Main_Page

    Laughing address! The address can kill the project! Why not a straightforward one, as in:

    www.vanillaWiki.com

    www.VanillaDocs.com

    ...

    If I were you, i didn't work at all on such rigmarole sub-domain! but on a beauty one, actually YES :)

    And it needs more thought, choosing the right wiki cms: MediaWiki? DukoWiki? github service? ...

  • My 2 cents : it's an intermediate work-in-progress Wiki. It needs to be merged with the real www.vanillaforums.org site anyway. We can work on any Url we like, but the work needs to be done. CSS specialists work on the Theming side of the VanillaWiki site. Programming specialists find all the functions in Vanilla using grep and someone needs to decide whether we scan the current source with phpdocumentor or whether we first update the source and then scan it.

    There was an error rendering this rich post.

  • hbfhbf wiki guy? MVP

    qwenty said:

    whu606 said:
    Have you checked through this:

    http://vanillawiki.homebrewforums.net/index.php/Main_Page

    Laughing address! The address can kill the project! Why not a straightforward one, as in:

    www.vanillaWiki.com

    www.VanillaDocs.com

    ...

    If I were you, i didn't work at all on such rigmarole sub-domain! but on a beauty one, actually YES :)

    And it needs more thought, choosing the right wiki cms: MediaWiki? DukoWiki? github service? ...

    @qwenty
    You want to pay to register the dns? Im hosting it for free to the community, why should i pay for a new domain? Especially when folks like yourself arent even willing to put in the effort to create a page. Makes little sense to me how you could be so critical, ive seen your contributions.

    Its hosted using media wiki... why? Its scalable and familiar to most people. If you would like to put more thought into it go ahead.

  • qwentyqwenty New
    edited May 2012

    Its hosted using media wiki... why? If you would like to put more thought into it go ahead.

    MediaWiki is ok, If I were, it was at top of my list.

    http://vanillawiki.homebrewforums.net/index.php/Main_Page
    Is this domain memorizable?
    Is this short & upstanding?
    ...

    qwenty said:

    And it needs more thought, choosing the right wiki cms: MediaWiki? DukoWiki? github service? ...

    It should start as an official work, not as fun on a sub-domain of a disjointed domain. (irrelevant to Vanilla)

    My intention:

    1. pre-hypothesis: Users wants to ground up a wiki on a good domain.

    THEN:

    1. Teamwork: gathering volunteers 2. solving host problem {who want(s) to pay for that?} 3. Choosing a charmer domain 4. choosing the best cms for wiki 5. ...

    Its scalable and familiar to most people

    +1

    this is my intention, different idea for brain storm!

    hbf said:

    @qwenty
    why should i pay for a new domain?

    It was my opinion. you have your idea, third party has his/her idea! :-)

    In my opinion a straightforward domain name will help more! even a free on can be better: www.VanillaDocs.tk (.co.cc, ...).

    Especially when folks like yourself arent even willing to put in the effort to create a page.

    Folks? It should be a team-work by staffs. Am I a Vanilla expert? Today I'm just a newbie! do you now how many days I'm familiar to Vanilla?

    Maybe tomorrow... If I try to learn as much as possible.

    ive seen your contributions.

    For example?

  • hbfhbf wiki guy? MVP

    qwenty said:

    ive seen your contributions.

    For example?

    my point exactly.

    as for the domain name:

    register a better domain name and have it redirect to my site if you want a cleaner URL. Like i said, i'm hosting it out of my domain/server as a service to everyone here. I've offered to package the whole thing up and hand it over to the vanilla core team any time they want to re-host.

    but if the domain name is why you think that people should not contribute to the wiki then im saddened by your complete lack of appreciation for what i and other people around here are trying to do for the community.

    You can't rely on the core team to take care of everything.

  • I honestly think she means well. I think and hope she will produce something comprehensive when she is ready.

    @hbf - Thanks for all of your work in setting the wiki up.

    I may not provide the completed solution you might desire, but I do try to provide honest suggestions to help you solve your issue.

  • qwenty said:
    It should be a team-work by staffs.

    We are the staffs. The community is. We can use all the help we can get (volunteers, yes). I understand that you say that you are a newbie, but we even could use your help.


    Would you like to help?

    Step 1 is for every time you wonder something and you cannot find it on the current Wiki, just add a page with the thing you're wondering.

    Step 2 is browsing the Wiki for information that needs adding. I know that you're a CSS expert, so look at the CSS pages. Do they need work?

    Step 3 is look for all the unanswered pages (red links) and see if you can add information

    Step 4 is transfer content from the actual forums of VanillaForums.org to the Wiki. Hint : I've been adding [Documentation] prefixes and 'documentation' tags to every discussion that ended in showing an answer to the user that had a question PLUS that was documented enough to put on the Wiki.

    Who else can help?

    There was an error rendering this rich post.

  • qwentyqwenty New
    edited May 2012

    UnderDog said:

    Hint : I've been adding [Documentation] prefixes and 'documentation' tags to every discussion that ended in showing an answer to the user that had a question PLUS that was documented enough to put on the Wiki.

    You solved one of my question: how [Documentation] prefix is added to some discussion?

    you do that manually by editing the first post? (respectable)

    Isn't better to create a new category called "Wiki candidates", then moving these discussion into it?

    You can't rely on the core team to take care of everything.

    right!

    if the domain name is why you think that people should not contribute to the wiki then im saddened by your complete lack of appreciation for what i and other people around here are trying to do for the community.

    @hbf

    Misapprehension! I never said that, did I? this is my phrase: If I were you, i didn't work at all on such rigmarole sub-domain! but on a beauty one, actually YES

    It was a suggestion for getting a bare domain. However, your work is really worthwhile.

  • 422422 Developer MVP

    Qwenty, ease up. Your attitude does grate on ppl, especially me.

    There was an error rendering this rich post.

  • qwenty said:
    you do that manually by editing the first post? (respectable)

    Thank you, thank you. I also accept PM's regarding posts and post titles, so I can change them if necessary.

    Isn't better to create a new category called "Wiki candidates", then moving these discussion into it?

    It's better to activate a plugin called 'discussion prefixes'. I have no control over plugins, applications (Wiki Application!) and categories though :-)

    There was an error rendering this rich post.

  • hbfhbf wiki guy? MVP

    qwenty said:

    UnderDog said:

    Hint : I've been adding [Documentation] prefixes and 'documentation' tags to every discussion that ended in showing an answer to the user that had a question PLUS that was documented enough to put on the Wiki.

    You solved one of my question: how [Documentation] prefix is added to some discussion?

    you do that manually by editing the first post? (respectable)

    Isn't better to create a new category called "Wiki candidates", then moving these discussion into it?

    This is a really great idea. It would make it much easier to find stuff to transfer to the wiki. I've had trouble searching to get items

    You can't rely on the core team to take care of everything.

    right!

    if the domain name is why you think that people should not contribute to the wiki then im saddened by your complete lack of appreciation for what i and other people around here are trying to do for the community.

    @hbf

    Misapprehension! I never said that, did I? this is my phrase: If I were you, i didn't work at all on such rigmarole sub-domain! but on a beauty one, actually YES

    It was a suggestion for getting a bare domain. However, your work is really worthwhile.

    obviously a language barrier issue then. because i read that statement to mean you dont recommend working on something on a sub domain such as mine.

    i think i generally understand your intention now. though admittedly i still have a hard time interpreting the statement directly.

  • hbf said:
    This is a really great idea. It would make it much easier to find stuff to transfer to the wiki. I've had trouble searching to get items

    http://vanillaforums.org/discussions/tagged/documentation

    There was an error rendering this rich post.

  • hbfhbf wiki guy? MVP

    UnderDog said:

    hbf said:
    This is a really great idea. It would make it much easier to find stuff to transfer to the wiki. I've had trouble searching to get items

    http://vanillaforums.org/discussions/tagged/documentation

    Perfect!

  • @hbf @qwenty
    I think I can stretch my budget and pay for the domain (i.e. vanillawiki.org or vanillawiki.com), and hosting of the existing MediaWiki docs, if @hbf is willing to export the hard work. I do think placing the Wiki on a primary domain will increase visibility. I don't think forwarding the domain is the best solution (credibility and SEO). It would be nice to get an endorsement from Vanilla on this effort.

  • hbfhbf wiki guy? MVP

    Just pay for the domain and have it's IP address pointed to my server, I'll take care of the rest.

  • @hbf so was the idea to redirect traffic to homebrew or was the idea to start a fresh wiki away from homebrew?

  • Tell you what guys, I'll pay for the domain. What domain do you want and what Nameserver do you want it to point too? Goooood Some people :P

  • @mabo said:
    Tell you what guys, I'll pay for the domain. What domain do you want and what Nameserver do you want it to point too? Goooood Some people :P

    I already purchased the domain.... and began working on a alternative wiki http://vanillawiki.org, that is why I asked my question...

Sign In or Register to comment.