Jump to:

17452 Posts in 4473 Topics by 1971 members

Archive

SilverStripe Forums » Archive » proposal for Forum - readability

Our old forums are still available as a read-only archive.

Moderators: martimiz, Sean, biapar, Willr, Ingo, simon_w

Page: 1 2
Go to End
Author Topic: 18580 Views
  • zyko
    Avatar
    Community Member
    66 Posts

    proposal for Forum - readability Link to this post

    i've a proposal for Forum layout.

    i think doing SilverStripe websites has todo a lot with writing code,
    and therefore this forum will be used often to show some pieces of code
    and discuss aout it.

    What would make things easyer was, if you would format this pieces of code
    in an alternate way.

    fe. if someone clicks 'View Formatting Help' beneath a thread, there it shows this
    'codeblock' BBode.

    I've done some threads using it, but the layout here doesn't differ from the rest of the posting.
    fe:
    http://www.silverstripe.com/site-builders-forum/flat/66662

    this is a codeblock, please show me in an alternate way ;-)

    if you look at the html, my 'code'-block has turned into a 'pre' statement.

    so, i think if someone would spend a minute, to css-fomat this tag
    in another layout,
    this forum could get an immediate 'boost' of readability ;-)

    g
    Helmut

  • Willr
    Avatar
    Forum Moderator
    5462 Posts

    Re: proposal for Forum - readability Link to this post

    Posting large blocks of code in the forum is a bit of a hassle and generally if you want to paste code in the forum we recommend using pastie - http://pastie.caboo.se/ and posting the link in the post. That way the code is nicely highlighted and formatted and users dont have to bear with great mass's of code outputs on the threads.

  • saimo
    Avatar
    Community Member
    67 Posts

    Re: proposal for Forum - readability Link to this post

    I have to agree with zyko here.
    code blocks should have a different style than the rest of the post, here are some points:

    • Keep indentation (as is done already)
    • Put the code in an iframe or a div with scrollbar, so that it is easy to skip past the code if you have already read it
    • Make the style of this div or iframe so that it is clear where is starts and ends, to improve overall readability of the post
    • Ideally provide syntax highlighting for php, css, xml markup, and template tags.

    I really think that being able to read the code directly in the message is important, both for readability and for archive reasons as well. What if someone googles a problem and finds a thread that seems to solve the problem, but all the code is somewhere else, in a paste that might not be around anymore?

    EDIT: It seems like there's a problem with the ulist tags as well, my ulist should be right below "here are some points:"

  • saimo
    Avatar
    Community Member
    67 Posts

    Re: proposal for Forum - readability Link to this post

    Well, that doesn't seem to work right either...
    this is how I meant for it to look (copy + paste + fixup):

    I have to agree with zyko here.
    code blocks should have a different style than the rest of the post, here are some points:

    * Keep indentation (as is done already)
    * Put the code in an iframe or a div with scrollbar, so that it is easy to skip past the code if you have already read it
    * Make the style of this div or iframe so that it is clear where is starts and ends, to improve overall readability of the post
    * Ideally provide syntax highlighting for php, css, xml markup, and template tags.

    I really think that being able to read the code directly in the message is important, both for readability and for archive reasons as well. What if someone googles a problem and finds a thread that seems to solve the problem, but all the code is somewhere else, in a paste that might not be around anymore?

    EDIT: It seems like there's a problem with the ulist tags as well, my ulist should be right below "here are some points:"

  • zyko
    Avatar
    Community Member
    66 Posts

    Re: proposal for Forum - readability Link to this post

    THX saimo.
    i have to agree to the following thing:
    "What if someone googles a problem and finds a thread that seems to solve the problem, but all the code is somewhere else, in a paste that might not be around anymore? "

    the main problem for me, starting with silverstripe was 'how to get into it'.
    if these code-fragements were outside, they wouldn't be searchable...
    and the first thing anyone does in theses days, is 'look for something similar'
    to my problem.
    becouse in 80% i'm not the first to have this problem...
    BTW: things would be better additionally, if dokumentation was capable of getting 'page-comments',
    (i wrote a trac-proposal for this)

    and if readability was better too, anyone could get things faster...

  • Willr
    Avatar
    Forum Moderator
    5462 Posts

    Re: proposal for Forum - readability Link to this post

    zyko for your proposal about doc comments you might want to add to it this plugin - http://wiki.splitbrain.org/plugin:discussion for docwiki. Seems that plugin would work pretty well.

  • sarahk
    Avatar
    Community Member
    46 Posts

    Re: proposal for Forum - readability Link to this post

    I'm happy with the caboo suggestion but it would be good to get the list styling sorted. I use it habitually and it really screws up here

  • zyko
    Avatar
    Community Member
    66 Posts

    Re: proposal for Forum - readability Link to this post

    Hi willr,

    WOW, yessss that docwiki-discussion plugin would be absolutely cool to have
    g
    helmut

    18580 Views
Page: 1 2
Go to Top

Want to know more about the company that brought you SilverStripe? Then check out SilverStripe.com

Comments on this website? Please give feedback.