Jump to:

23487 Posts in 18996 Topics by 2878 members

General Questions

SilverStripe Forums » General Questions » The only bad side of Silverstripe...

General questions about getting started with SilverStripe that don't fit in any of the categories above.

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

Page: 1 2 3
Go to End
Author Topic: 4032 Views
  • fishe
    Avatar
    Community Member
    42 Posts

    Re: The only bad side of Silverstripe... Link to this post

    This isn't just an issue with SilverStripe...it seems all the open source CMS products I've checked out recently (including the big ones like Drupal, Joomla and CMS Made Simple) have terrible documentation. Generally they suffer from the "written by developers, for developers (that sit in the next cube)" problem.

    E.g. the docs.joomla.org wiki is a sprawling mess of random user input, with little fitting together. Cohesion and quality are the big factors.

    It seems that SS could make documentation and tutorials a serious priority - it would be a nice strategic advantage over all the other free CMS' out there. SS is already half way there with the current tutorials and documentation...just need some good technical writers to fill in all the gaps, keep things up-to-date and reform the current stuff in terms of language and unnecessary jargon.

    Documentation can be made a critical component of the product, with business rules supporting this. For example, before any new version is released all documentation must be up-to-date in line with the new release, while still maintaining backwards support/compatibility with older versions - and this must be rigorously checked/enforced.

    IMHO the aim should be to create a graded entry system whereby potential new users can "slot in" where they feel comfortable in the structure of the tutorials/documentation. Starting at the very basics of CMS principles and even basic PHP tutorials as it relates to SilverStripe.

    I really like the structure you guys have at present of different Levels of documentation - it's a great concept.

    I'm Looking forward to seeing what can be done

  • Aram
    Avatar
    Community Member
    598 Posts

    Re: The only bad side of Silverstripe... Link to this post

    Was looking at the Joomla forum today and noticed their stats, thought it might give a better indication of how far SS has to go before it can compete in terms of community size:

    Joomla
    Total members: 247,349
    Total posts: 1,491,981
    Total topics: 328,751
    Most users ever online was 2,459

    Silverstripe
    Total members: 2,145
    Total posts: 19,006
    Total topics: 4,909
    Most users ever online was ....er 10 if were lucky??? lol

    As was mentioned the V2.x status of SS is a little misleading considering Joomla is still only at V1.5!

  • Ronin
    Avatar
    Community Member
    50 Posts

    Re: The only bad side of Silverstripe... Link to this post

    Just to balance things I'd like to add my concern at the quality of the Tutorials and the responses to items posted on the Forum. I'm a kiwi and that is why I chose SS. I want to succeed with the product but have found difficulties with the tutorials. I'm new to web stie design and development but not to programming and system development. Currently I'm on Tutorial 4 and although I have successfully got the seach dialog box appearing on the screen when I enter a search string nothing is returned whether the string is valid or otherwise. No error is generated. I have put 2 posts on the forum and am still waiting for help.

    It is quite possible that the problem is something that I've done or not done. However this doesn't really matter the point is I need to solve the problem and for that I need help and better documentation.

    Just my comments to show that there are others that are disappointed with their experience to date

  • solar
    Avatar
    10 Posts

    Re: The only bad side of Silverstripe... Link to this post

    First off I want to thank Aram for answering my question on the forum a few days ago.
    I installed SS on xampp about 1 year(or more) ago with success and on my hosting company with no success. After the last version with the bug fixes, it installed with out a hitch. While I'm new to php and oop I must say after looking around under the hood, this CMS seems very clean and well written. There are some parts of the tutorial section many seem to have a hard time with....as for my self I can only find one part that has changed(make this page default home page tut1). I have stepped away from SS a few time because of the lack for documentation, I totally understand this because SS is still young and up and coming. For a small community the forums answers questions a lot better then they did a year ago. I think once the tutorial section gets rewritten then we can expect to see a lot more people using SS. I think more of us of the forum should also write tutorials on SS in order to promote it. I shal be writing a few in the near future once I figure out must of the coding and so forth(i'm more of a designer).

    @fishe
    "Generally they suffer from the "written by developers, for developers (that sit in the next cube)""
    Yes thats the problem right there, but I think most people need to learn phpOOP before they attempt to configure SS
    P.S. thank you to the SS team.

  • IanP
    Avatar
    Community Member
    5 Posts

    Re: The only bad side of Silverstripe... Link to this post

    There's some fair points made on both sides, I think.

    As a new SS user, I would concur with the concerns about documentation. I've only worked through the first two and a half tutorials, which I think are very good (and have worked fine so far) and also very enjoyable. It's actually the wiki that concerns me; it's still very sparse. A few times I've dipped out of the tutorials to find out a little more and been disappointed.

    The forums are friendly enough though, which bodes well. Although I'd like to see signatures enabled, so those people or companies offering professional services can make themselves known.

    The only thing stopping me -- and thus my company -- becoming a pure SilverStripe studio is the nested URL issue. As I've said elsewhere, it has made it incredibly hard to "sell" the system to 2-3 clients now.

  • simon_w
    Avatar
    Forum Moderator
    473 Posts

    Re: The only bad side of Silverstripe... Link to this post

    I'll also like to mention the IRC channel. If there's something you need some quick help with, it's likely that you'll get it, assuming that there's someone online that can help. NZ business hours are generally good times.

  • simon_w
    Avatar
    Forum Moderator
    473 Posts

    Re: The only bad side of Silverstripe... Link to this post

    Duplicate post.

  • Willr
    Avatar
    Forum Moderator
    5508 Posts

    Re: The only bad side of Silverstripe... Link to this post

    The only thing stopping me -- and thus my company -- becoming a pure SilverStripe studio is the nested URL issue

    IanP, you might like to look into used the nested URL branch. We have it running on 1 client site of ours and seems to work (but its surely not what you could call stable). Hopefully nested URLs will be a part of the main 2.4 release, but if you want to muck around with nested urls then ajshort has done some good work on that branch adding support for it.

    The documentation is currently being rewritten and rebuilt so that is why you will notice no alot of updates in the wiki in the past 3 months. We keep talking about it but it will be tidied up sometime (this year hopefully )

    4032 Views
Page: 1 2 3
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.