Skip to content
This repository has been archived by the owner on Feb 22, 2024. It is now read-only.

Recommended common structure for readmes of transformers. (work-in-progress)

License

Notifications You must be signed in to change notification settings

fusepoolP3/p3-transformer-readme

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 

Repository files navigation

<name> Transformer Build Status

Introduction:

  • Readme should always start with a short introduction
  • Around 3-6 sentences
  • What is it and what is it doing
  • The Travis build status image (if available) should be added to the readme

Try it out

  • Shows the minimum step needed to see some action
  • This section should be omitted if it can't be short
  • It should use the latest released version (see here) and not the sources

Compiling and Running

  • Most readmes already contain such information under different chapternames (Building and running, Install and run, Building from source, etc.)
  • How to build it from source and run it
  • How to run it as binary
  • What are the commandline options

Usage

  • Most readmes already contain such information in some form
  • How to invoke the transformer using GET and POST
  • cURL based examples
  • Can contain subchapters for better readability
  • Codes and examples should be code formated

Additional chapters

  • Any additional chapter should come after the Try it out, Compiling and Running and Usage chapters for better readability

Optional: Add the links to the JIRA issues at the end of the readme, but they should notbe necessary to understand things.

About

Recommended common structure for readmes of transformers. (work-in-progress)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published