Ufuk Celebi created FLINK-4317:
----------------------------------

             Summary: Restructure documentation
                 Key: FLINK-4317
                 URL: https://issues.apache.org/jira/browse/FLINK-4317
             Project: Flink
          Issue Type: Improvement
          Components: Documentation
    Affects Versions: 1.1.0
            Reporter: Ufuk Celebi
            Assignee: Ufuk Celebi
             Fix For: 1.2.0


- Documentation is not well grouped into categories according to what is 
relevant in different steps of the development and deployment process
- The current layout has not enough top-level navigation menus to guide people 
that look for docs. Experience shows that anything hidden in a larger document 
linked from a sub-menu is overlooked by many people.

Concepts
- Overview: Similar to the current start page, stack and brief description
- Concepts: Similar to what we currently have
- Architecture: Process model (JM / TM / Client / …)
- Project Structure: Core Maven artifacts, what needed when, relationships
Semantics

Setup & Operations
- Setup: Downloading, Building from Source, Hadoop Versions / Scala Versions
- Deployment Options: Yarn, Mesos, Standalone, etc
- Configuration
- Failure & Recovery Model
- Security Model

Application Development
- Quickstarts 
- APIs: Streaming, Batch, Table, SQL
- Event Time and Windowing Semantics
- Libraries
- State Backends
- Connectors, End-to-end Exactly-once
- Data Types: Types, Serialization (Custom, Kryo, Avro), Lambdas, Hints, 
Extensibility

Testing & Debugging
- Testing and test utilities
- Debugging
- Monitoring: Web Frontend, Metrics
- Tuning: Memory, CPU, GC
- Operations: Version Upgrades, etc

Internals
- how does it work




--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Reply via email to