linebender/druid

Adding to the book

Open

#1729 opened on Apr 19, 2021

View on GitHub
 (4 comments) (6 reactions) (0 assignees)Rust (9,091 stars) (567 forks)batch import
docshelp wanted

Description

Hi, there are some parts of the book that I think don't need a druid expert in order to write. Would it be fine to leave this issue here and track what parts need help or entire additions? I can probably add a task list.

So this is a rough task list split by chapters:

Getting Started With Druid

  • Finish Application state section
  • Write Handle user input section
  • Write Putting it all together section

Localization

  • I don't know what needs to be done here.

Command

  • I also don't know what need to be done here.

Widgets in Depth

  • Layout
  • how constraints work
  • child widgets and set_layout_rect
  • paint bounds
  • container widgets
  • widgetpod & architecture
  • commands and widgetid
  • focus, active, hot, (disabled when it gets there)
  • request paint & request layout
  • changing widgets at runtime

More information

  • Add more to the projects using druid ( There are a few new projects in #1360 )

Contributor guide

Tech stack
rust
Domain
documentation
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
over 1 week
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Basic Rust knowledgeFamiliarity with druid conceptsAbility to write technical documentation
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
60
Research direction
Look at the existing Druid book structure in the repository, see which sections are already written. Focus on the 'Getting Started With Druid' tasks first. For the 'Projects using Druid' section, refer to the list in #1360. Write clear, example driven documentation.