Open Documentation Wiki

Discuss all feature requests you have for a new Servoy versions here. Make sure to be clear about what you want, provide an example and indicate how important the feature is for you

Open Documentation Wiki

Postby Bernd.N » Fri Feb 28, 2014 9:14 pm

Hi,
I currently learn Servoy and naturally stumble over points where I can not find documentation.
One example is "sequence type" in the table editor, where I tried to google with 'servoy "sequence type" ' and did not find any simple explanation of them. What I need is just a one-sentence-explanation to each type
servoy seq:
db seq:
db identity:
uuid generator:

There are dozens of similar examples when you learn a new system, and it often needs hours to google them and try to figure them out.

Therefore I would like to suggest an open documentation wiki, which could have a simple structure and where people registered in this forum could add items when they look for something and finally figure it out. Example for the structure (the doc is my current state of knowledge, please excuse when there are faults):

Form Elements
___Text Field
______onAction-Event: triggers when.../do not use when.../be careful when...
______onDataChange-Event: triggers when.../do not use when.../be careful when...
______ ....
______onRightClickEvent: triggers when.../do not use when.../be careful when...
______anchors: ...
______background: consider to use CSS-styles...
______....
______editable: ...
______enabled: the difference to editable is...
______....
______valuelist: ....
______visible: ....
___Text Area
___....
___Spinner
___Portal

Eclipse Table Editor
___Table Columns
______Name
______- Maximum N characters when you want to be compatible with PostgreSQL/SQL Server/Oracle/MySQL
______- Do not use big letters as some DBs have problems with that
______- Use always [tablename]_id as name for the primary key to have a useful convention
______...
______Type
_________TEXT
_________- Use -1 as length to get a text field without fixed length
_________INTEGER
_________....
______AllowNull
______ - Deactivate rarely as you will face additional challenges when adding new records
______....
______Sequence Type
_________servoy seq: Explanation...
_________db seq: Explanation...
_________db identity: Explanation...
_________uuid generator: Generates a unique UUID for a TEXT field with length 36
______....

Hope you get the idea.
In case you are an expert already, it might look needless, but for Servoy newbies, it would be a great help.
It would result in faster learning, and the Servoy community would grow even faster, which is in everyone's interest, I think. :)

Whats more, it could be a single point for assembling detailed knowledge to those topics.
And Wikipedia shows that it is possible to work on a large wiki together, the quality is improved through everyone who reads and changes it when necessary with responsibility.

Bernd
Bernd Korthaus
LinkedIn
Servoy 7.4.9 SC postgreSQL 9.4.11 Windows 10 Pro
User avatar
Bernd.N
 
Posts: 544
Joined: Mon Oct 21, 2013 5:57 pm
Location: Langenhorn, North Friesland, Germany

Re: Open Documentation Wiki

Postby david » Sat Mar 01, 2014 2:31 am

David Workman, Kabootit

Image
Everything you need to build great apps with Servoy
User avatar
david
 
Posts: 1727
Joined: Thu Apr 24, 2003 4:18 pm
Location: Washington, D.C.

Re: Open Documentation Wiki

Postby Bernd.N » Sat Mar 01, 2014 12:39 pm

Thanks a lot, David, so just trying to google something without reading the docs first seems not a good idea. Lesson learned. :)

Would be nice if there would be a direct link from the specific data field in Eclipse Environment to this docs, maybe by right mouse click or something like that.
Bernd Korthaus
LinkedIn
Servoy 7.4.9 SC postgreSQL 9.4.11 Windows 10 Pro
User avatar
Bernd.N
 
Posts: 544
Joined: Mon Oct 21, 2013 5:57 pm
Location: Langenhorn, North Friesland, Germany

Own table based Wiki

Postby Bernd.N » Mon Jan 05, 2015 5:54 pm

During my first 8 month of coding with Servoy (which I enjoy more and more), I found it useful to create a small wiki for topics I want to remember.
Saves me time to look that things up elsewhere.
The tags in the first column just mean Postgres (pg) and Servoy Developer (sd).
Attachments
table_based_wiki.png
table_based_wiki.png (113.83 KiB) Viewed 5652 times
Bernd Korthaus
LinkedIn
Servoy 7.4.9 SC postgreSQL 9.4.11 Windows 10 Pro
User avatar
Bernd.N
 
Posts: 544
Joined: Mon Oct 21, 2013 5:57 pm
Location: Langenhorn, North Friesland, Germany


Return to Discuss Feature Requests

Who is online

Users browsing this forum: No registered users and 3 guests