#1
As someone who has been working in I.T. for 30 years, I am appalled at the lack of documentation.

Documenting this application should be your Number One priority before going any further with new features.

The documentation should be created at the same time as you are creating/modifying the application.

There needs to be a detailed description, including examples, of how to use each Configuration option.

Any excuses, regarding the application being Open Source, are invalid.

Secondly, the English, in places, is terrible. If English is not your native language, then, you should ask someone, whose native language is English, to verify that the Spelling and Grammar are correct.

The lack of documentation and imperfect English make the application appear unprofessional.

Thank you, Michael.
Topic Starter
  • mtbvfr
  • Rank: YAF Camper
  • Reputation:
    Neutral
    50.2%
  • Joined: 21/05/2012
  • Posts: 22
  • Thanks: 9 times
#2
This is also a community supported project, and always has been. You say that an application being open source is invalid excuse, but in all reality it is totally valid. Developers concentrate on new features, bug fixes, and improvements in the code - and this is constant, in an effort to produce a stable usable product, and in the end, it's free. There's no charge. You can basically do with it what you want.

I'm not a developer, creator, or any of the such, but for the last year, I have done what I can to help other members via the support forums - donating many hours of my time to help support the project, mainly since I am unable to contribute financially to it's hosting or further development. There are very few of us who actually try to help grow and support the project in any way we can. We have asked for community help repeatedly when it comes to the documentation. In all honesty, nobody would be better suited to contribute documentation than users and administrators who are using the product. Developers already know and understand what the features are there for and how they work, so in many cases it is not 'that easy' to properly document something for them.

While I can understand your feelings, I hope you can understand mine on this issue. I find it almost rude to word things the way that you did in response to a 'freely available product' that in order to find an alternative with as many features, you will be spending large sums of money, not only for the product but for support as well.

My only thoughts about the bad english go right back to the concept of this being a user supported project, with several developers. They rely heavily on the bug tracker and the forums to help make the product better. If you know where the english issues are, please point them out. Lodge a report in the bug-tracker, or post in the Bug Reports forum so that we can address the issue and get it taken care of. We all work together to try to make this project and application what it is - but nobody is perfect, and english is not the only language in the world - I am sure that the other languages also have problems in the code as well. But without input from the users of the software, things like that can get overlooked while developers are concentrating on other parts of the application (mainly bug fixes and code optimizations/improvements).

** the thoughts and comments in this post are mine and mine alone. I do not speak for the other developers or the rest of the YAF team in this post. **
If you can't find it using the forum search, try my signature link -- searches this site using Google: Google is my Friend 
  • squirrel
  • Rank: YAF Leader
  • Reputation:
    Exalted
    100%
  • Medals:
    YAF.NET Supporter: Loves YAF.NET!YAF.NET Supporter: Supports the YAF.NET project with a contribution.YAF.NET Purple Supporter: Purple heart for being an Asset to the YAF.NET Community.YAF.NET Supporter: Supports our efforts. Thank you.Medal of Honor for the Support King: A huge help to the YAF.NET community!
  • Joined: 14/01/2010
  • Posts: 925
  • Thanks: 249 times
  • Was thanked: 169 time(s) in 160 post(s)
#3
Interesting, I have been in the field for a long time as well, and documentation is often a neglected area, even from commercial products. As Squirrel pointed out, its an area that help has been asked for with. Since your using the software, and are very concerned about the state of the documentation, perhaps you would like to contribute by helping update it?
  • Thantis
  • Rank: YAF Commander
  • Reputation:
    Honored
    81.8%
  • Joined: 04/08/2011
  • Posts: 86
  • Thanks: 11 times
  • Was thanked: 21 time(s) in 18 post(s)
Users browsing this topic
    Forum Jump  
    • You cannot post new topics in this forum.
    • You cannot reply to topics in this forum.
    • You cannot delete your posts in this forum.
    • You cannot edit your posts in this forum.
    • You cannot create polls in this forum.
    • You cannot vote in polls in this forum.

    About Us

    The YAF.NET is an open source .NET forum project. YAF.NET is supported by an team of international developers who are build community by building community software.

    Powered by Resharper Donate with PayPal button

    Project Twitter Updates

    Copyright © YetAnotherForum.NET & Ingo Herbote. All rights reserved