No description
Find a file
2020-12-21 23:21:53 -05:00
.github/workflows Initial commit 2020-12-21 23:21:53 -05:00
spec Initial commit 2020-12-21 23:21:53 -05:00
src Initial commit 2020-12-21 23:21:53 -05:00
.editorconfig Initial commit 2020-12-21 23:21:53 -05:00
.gitignore Initial commit 2020-12-21 23:21:53 -05:00
LICENSE Initial commit 2020-12-21 23:21:53 -05:00
README.md Initial commit 2020-12-21 23:21:53 -05:00
shard.yml Initial commit 2020-12-21 23:21:53 -05:00

README

Template repo for creating a new Athena component. Scaffolds the Crystal shard's structure as well as define CI etc.

NOTE: This repo assumes the component will be in the athena-framework org. If it is to be used outside of the org, be sure to update URLs accordingly.

  1. Find/replace COMPONENT_NAME with the name of the component. This is used as the shard's name. E.x. logger. 1.1 Be sure to rename the file in ./src, and ./spec as well.

  2. Replace NAMESPACE_NAME with the name of the component's namespace. Documentation for this component will be grouped under this. E.x. Logger.

  3. Find/replace CREATOR_NAME with your Github display name. E.x. George Dietrich.

  4. Find/replace CREATOR_USERNAME with your Github username. E.x. blacksmoke16.

  5. Find/replace CREATOR_EMAIL with your desired email

    5.1 Can remove this if you don't wish to expose an email.

  6. Find/replace ALIAS_NAME with the three letter alias for this component; A + 2 letter shortcut to NAMESPACE_NAME. E.x. ALG.

  7. Find/replace DESCRIPTION with a short description of what the component does.

Delete from here up

NAMESPACE_NAME

CI Latest release

DESCRIPTION

Installation

  1. Add the dependency to your shard.yml:
dependencies:
  athena-COMPONENT_NAME:
    github: athena-framework/COMPONENT_NAME
    version: ~> 1.0.0
  1. Run shards install

Documentation

Everything is documented in the API Docs.

Contributing

  1. Fork it (https://github.com/athena-framework/COMPONENT_NAME/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors