Docs

[schtr4jh]

First, I need to create docblocks and comment whole code so other developers will be able to understand it. Then I need to write some examples of how to build simple and advanced queries, define relations, use event dispatcher, use collections and transformations, use i18n, l17n and other extensions, and basically document every functionality. :)

• 1. Repository
• 1.1. PDO
• 1.2. Faker
• 1.3. Custom
• 2. Entity
• 2.1. Relations
• 2.1.1. Has many
• 2.1.2. Belongs to
• 2.1.3. Has and belongs to
• 2.1.4. Morphs many
• 2.1.5. Morphed by
• 2.1.6. HasOne
• 2.1.7. HasChildren
• 2.1.8. HasParent
• 2.2. Extensions
• 2.2.1. Deletable
• 2.2.2. Translatable
• 2.2.3. Localizable
• 2.2.4. Orderable
• 2.2.5. Paginatable
• 2.2.6. Permissionable
• 2.2.7. Timeable
• 2.2.8. Adapters
• 2.2.8.1 Auth
• 2.2.8.2 Lang
• 3. Record
• 3.1. Actions
• 3.2. Events
• 3.3. Extensions
• 3.3.1. Deletable
• 3.3.2. Permissionable
• 3.3.3. PrevAndNext
• 3.3.4. Translatable
• 4. Query
• 4.1. Select
• 4.2. Delete
• 4.3. Update
• 4.4. Insert
• 5. Helpers
• 5.1. Convention
• 5.2. Cache
• 6. Collection
• 7. Field

[felipextrindade]

Can you provide more info on this?

[schtr4jh]

Hey @felipextrindade, thanks for participating (or at least trying to :)). pckg/database package is (along with order pckg packages) used on few projects, but because of the lack of the time I was not able to document changes during development (lame excuse, right, I promise I will change this in the future :)).

What I want to do is write docs for all pckg projects. I know this is long shot since code is currently not well documented and will take a lot of time to do it, but I have to begin somewhere, right. :)

[Menelion]

@schtr4jh, so maybe is it worth to split the huge docs issues so several people could contribute various parts of the docs independently? I would try, for example, but I'm not sure I will manage to do the whole thing during October :). Thanks!

[schtr4jh]

@Oire Hello and thanks to you too ;)

I've created table of contents for better overview. I will mark section as done when we write docblocks, comment all code and write documentation in wiki.

I will also prepare some guidelines for contribution and create wiki pages. Any english fluent speaker/writer would be appreciated for writing/editing documentation. :)