Adam's Lair Forum

Is there a topic you'd like to know more about? Request it here, so we can get to work documenting it! This will help us determine which topics are most wanted and / or lacking sufficient documentation. When documentation has been extended in response to a request, feel free to post in this thread about it as well.

Template for requests:



What's the difference between a Docs Page and a Tutorial?

• Docs Page: Outlines functionality, usage and theory based on the described topic.
• Tutorial: Outlines a sequence of actions based on a goal, while providing the subset of knowledge about the described topic that is required to do so.

Edit: For more advanced requests, complete with a list of topics and potential article structure, I have created a new GitHub milestone where one issue per requested Wiki article can be submitted. These issues can also be used for discussing progress and implementation of each article.

_________________
Blog | GitHub | Twitter (@Adams_Lair)

Requesting: Docs Page
Topic: Cameras
Summary: I'd like to learn about how cameras work, how using multiple cameras work and how to correctly manipulate them in code and the editor (size, view-ports, positions, etc).

To add to this also overlays...

I'd like to know what are camera passes and how to properly make an UI.

Here's a small list of topics I think would benefit most new people:

Requesting: Docs Page
Topic: Project View
Summary: What appears in it, and how to use it. Further reading: recommended directory structure

Requesting: Docs Page
Topic: Object Inspector
Summary: What it's useful for, how to use it, and how it interacts with C# classes

Requesting: Docs Page
Topic: Scene View
Summary: What appears in it. Further reading: How scenes work

Requesting: Docs Page
Topic: Prefabs
Summary: What is a prefab. What should prefabs be used for. How to use them

Requesting: Docs Page
Topic: Pixmaps, Textures, and Materials
Summary: Differences between each type, use cases for each

Requesting: Docs Page
Topic: RenderTarget
Summary: What is a RenderTarget. What to use them for. How to use them

Requesting: Docs Page
Topic: SpriteRenderer and AnimSpriteRenderer
Summary: Differences and use cases, how to use AnimSpriteRenderer

Requesting: Docs Page
Topic: RigidBody
Summary: What is a RigidBody. How to use them. How to achieve different physics effects with them

Requesting: Docs Page
Topic: Application Data
Summary: What it's used for. How to use it. How to use CustomData

Requesting: Docs Page
Topic: Default User Data
Summary: What it's used for. How to use it

Requesting: Docs Page
Topic: Package Manager
Summary: What it does. How to install packages. How to publish packages

Requesting: Docs Page
Topic: CorePlugin.cs
Summary: What it's used for. What you might typically put in it

Requesting: Docs Page
Topic: Scene View
Summary: Description of each tool on the toolbar. Description of Game/RigidBody/Scene views



EDIT: Where can I edit the documentation?

I have created a new GitHub milestone specifically for easing the learning curve of Duality. If you have a more concrete idea on a specific topic, complete with a list of sub-topics to deal with, feel free to submit an issue to the tracker! We can also use these issues to keep track of each topic's progress, as well as discuss its article.

When submitting a new issue, please follow the overall structure that you can see in existing issues. Also keep in mind that each issue should be as self-contained and close-ended as reasonably possible.

So far, I've added a few issues for more advanced topics that came up recently which I'll probably deal with myself, but feel free to add your own ones too. If you plan on writing an article on an issue, please comment so it's clear that this one is blocked for the moment

_________________
Blog | GitHub | Twitter (@Adams_Lair)