airbnb/epoxy

[Feature request] Model documentation generator.

Open

#522 opened on Sep 4, 2018

View on GitHub
 (3 comments) (0 reactions) (0 assignees)Java (738 forks)batch import
help wanted

Repository metrics

Stars
 (8,412 stars)
PR merge metrics
 (No merged PRs in 30d)

Description

Hi! First of all, thanks for creating and open sourcing Epoxy, it really simplifies and optimizes developing features.

After extending the usage of Epoxy in a large app, and building dozens of components, we're facing a situation where sometimes models are duplicated because of members of the team don't realize they already exist.

Our suggestion would be to take advantage of the annotations and generate a centralized documentation or model catalog.

A similar tool in the react world could be React docgen

Thanks so much again for this awesome project!

Contributor guide

Research direction
Research how to parse Epoxy model annotations at compile time or runtime to generate documentation. Explore options like annotation processing or reflection.
Tech stack
java
Domain
mobile
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
JavaAndroid
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
50