| 6 |
7u83 |
1 |
Resources for New Developers
|
|
|
2 |
============================
|
|
|
3 |
|
|
|
4 |
When introducing TenDRA to developers who're interested in TenDRA, I
|
|
|
5 |
find myself repeating explanations of various things. These are, roughly:
|
|
|
6 |
|
|
|
7 |
* A quick overview of what TenDRA is, who made it, and why
|
|
|
8 |
* How it differs from other projects in implementation
|
|
|
9 |
* How it differs in goals and mentality (this is vital to convey if we want
|
|
|
10 |
to attract new developers! - less important for users)
|
|
|
11 |
* Our future plans
|
|
|
12 |
* What each component is for
|
|
|
13 |
* What state the project is in, and why it's not usable (this is two
|
|
|
14 |
parts: refactoring and obsolescence)
|
|
|
15 |
|
|
|
16 |
The "how it differs" part requires some conceptual orientation;
|
|
|
17 |
explaining about making the IR accessible (as TDF), for example, and
|
|
|
18 |
the repercussions that has.
|
|
|
19 |
|
|
|
20 |
As for components, we would benefit from documentation giving overviews
|
|
|
21 |
of each, and what they're for. An orienting overview of how they fit
|
|
|
22 |
together would also help.
|
|
|
23 |
|
|
|
24 |
Components that spring to mind:
|
|
|
25 |
|
|
|
26 |
* ANDF and TDF
|
|
|
27 |
* tspec and the abstract APIs (now that would be a good band title)
|
|
|
28 |
* Error message reporting. Everybody loves this!
|
|
|
29 |
* lexi and sid: in particular, sid's LR -> LL approach
|
|
|
30 |
|
|
|
31 |
The emphasis here is on introducing new concepts, rather than explaining
|
|
|
32 |
details of how they're used (that reference detail can be in usage
|
|
|
33 |
guides instead).
|
|
|
34 |
|