Vanilla Tutorial/Documental Site

124678

Comments

  • hbfhbf wiki guy? MVP
    edited February 2012

    Jongos said:
    @hbf

    > .php.source-php .de1, .php.source-php .de2 {
    >     background:none repeat scroll 0 0 transparent;
    >     font:1.0em/1.2em monospace;
    >     margin:0;
    >     padding:0;
    >     vertical-align:top;
    > }
    > 

    changing the font line to 1.2em/1.4em monospace seems to make it at a nice size.

    and one more problem, the long lines not wrapping.

    just add "white-space: pre-wrap;" to the css.

    done.

    I continue to be amazed at the progress you guys are making on the content.

  • Only just noticed this, happy to help out where and when I can

  • hbfhbf wiki guy? MVP

    clethrill said:
    Only just noticed this, happy to help out where and when I can

    @clethrill feel free to jump in and modify / add content where ever you can. Don't worry about starting things you can't finish, it ok. others will help round out content. just capture what you feel is important.

  • hbfhbf wiki guy? MVP

    and the path to the wiki is

    http://www.homebrewforums.net/vanillawiki/

    just posting it again so you don't have to search through this thread to find it.

  • @hbf

    some padding would be nice. to the code box would be nice.

    same css selectors. padding : 12px;

  • hehe.. it's blue now! I'm loving it!

    been thinking about it too but thought too much to ask.

    nice!

  • hbfhbf wiki guy? MVP

    ******** NOTE *********

    I've moved the wiki to a new address.

    http://vanillawiki.hombrewforums.net

    this should be a more user friendly address. The old address still works, but i recommend you begin using this one, as eventually I will retire the old one.

  • designers and developers section almost cover all that's covered in the official doc site.

    I'm doing quick guide on writing application as i am making one. along the way will fill in infos on all the main classes (API section) as i read them to understand applications. Already covered Gdn_ApplicationManager.

    will need reviews and corrections.

  • hbfhbf wiki guy? MVP

    Jongos said:
    designers and developers section almost cover all that's covered in the official doc site.

    I'm doing quick guide on writing application as i am making one. along the way will fill in infos on all the main classes (API section) as i read them to understand applications. Already covered Gdn_ApplicationManager.

    will need reviews and corrections.

    i've been trying to review as i notice new content. mostly making typographical corrections. you're way ahead of me on the technical content.

  • 422422 Developer MVP

    Cannot get to your new url three posts up, is it live?

  • hbfhbf wiki guy? MVP

    422 said:
    Cannot get to your new url three posts up, is it live?

    yes, it's live for me. please try again, maybe the DNS just hasn't updated on your end?

    Is anyone else having trouble reaching the new address?

  • hbfhbf wiki guy? MVP
  • hbfhbf wiki guy? MVP

    i would edit the original post but, alas, i can not.

  • JongosJongos
    edited February 2012

    Can't decide the best way to document a class....

    How do we want a class documented?

    Presenting all info in table form or should the table contains only the basic info and the rest in it's section?

    If in table form, the space might be restricted.

    If all method is in their own subsection, might be a bit harder for brain to digest (that's how it seems to me). And a method prone to be left out when checking it's validity after a new update is available.

    like, an important methods (those commonly used, esp. those in Gdn_Controller) might need a good elaborate explanations and examples.

  • I wouldn't re-invent the wheel. Code documentation should be done with code documenting software.

    Wiki should be more about how to, but teaching general php is a bit beyond its scope. However the code doc could be linked.

    There is already in-line documentation, although some of it is incomplete, and occasionally incorrect, a code documenter should be able to pull this out of the code base.

    grep is your friend.

  • phpBB3 uses PHPDoctor for documenting its code debase. This might be an option, or some other.

    grep is your friend.

  • Regarding the Classes :

    reason i want to cover classes in the wiki :

    1. I've already made a doxygen doc (i shared a download link in this forum), but a lot of methods is missing inline documentation. I had to include source code to it, but then it's hard to read. Try generate one or download the one i shared. It's helpful in visualising the relationship between classes but not in describing what a class/method do.

    2. Methods/params that I don't understand or is not so clear what it's about even after jumping from file to file, hopefully someone would explain in plain term. Setting a breakpoint in debugger and try to trace thru trace stack is very time consuming. Add sample output, etc.

    3. It's a wiki, anyone can contribute. You dont have to have access to hbf server filesystem to edit the docs, unlike a generated docs.

    I'm not expecting the whole Garden library would be documented, just the fundamentally important ones that matter to most apps and/or plugins.

    Regarding PHP :

    I guess you're talking about the Help for Learning Programmers, it's just merely to tell them that such a concept exist.

    It's from my own experience, trying to learn OOP & Framework and stuck again-again in 10 years, because it simply didn't register to me that concepts of software pattern etc. exist.

    So when i tried to learn stuffs like Joomla, I went like "wtf, what kind of code is this, how can this work, just when do the classes got instantiated?" simply because I didn't know there was such a thing as Factory pattern and that is not covered in any OO book I've read. No one cared to say "joomla use the factory pattern in".

    It's not gonna teach much, just links and excerpts, and how it is applied in Vanilla.

    When i say "Learning Programmers" it includes me, and i put it so i could put my notes/bookmarks to share with others.

  • JongosJongos
    edited February 2012

    @hbf

    can you please add this extension, http://en.wikipedia.org/wiki/User:MarkS/Extra_edit_buttons

    inserting code/small/pre/ tags manually repetetively is quite irritating...

Sign In or Register to comment.