Official documentation

[baosu311]

Official documentation is a key resource for beginners to learn, but the descriptions in official docs are often too brief and haven't been updated for a long time, which significantly increases the learning curve.

For example, regarding this issue ( #2216 ),
I would never have thought user attributes could be used this way if you hadn't answered my question.

[merks]

The problems here are on several fronts:

• The people with the most knowledge typically know most things so don't need the documentation and don't like writing documentation.
• The people who need the documentation don't know enough to help write it, and probably won't help write it even when they can.
• The people who want things generally hope someone else will do it for them and even if they could contribute, they generally don't want to do that.
• The people with money generally don't want to spend it when then can get it for free instead.

None of these are likely to change.

---

Also, I have no idea how to update the docs which appear to be bit of a dead zone:

• https://github.com/eclipse-birt/birt-website/pulls
• https://github.com/eclipse-birt/birt-website/issues