Java Design Patterns

🎹 Table of contents

Java Design Patterns

☝ Summary

Java Design Patterns is intended to provide various use case scenarios and architectural concepts on prototyping adaptive applications.

mkdocs.yml    # Configuration file.
docs/
    readme.md  # General information
    summary.md  # Table of contents
    units/
        design-patterns.md # Design patterns and architectural concepts
        scenarios.md # Scenarios in practice
        use-cases.md # Typical use cases
    user-guide/
        changelog.md # Changelog page
        code_of_conduct.md # Code of conduct page
        code_owners.md # Code owners page
        dependency.md # Dependency page
        description.md # Description page
        faq.md # FAQ page
        getting-started.md # Getting started page
        troubleshooting.md # Troubleshooting page
        upgrade.md # Upgrade page
    reporting/
        info.md # Informational page
        issue_template.md # Issue template page
        bug_report.md # Bug report template
        custom_report.md # Custom report template
        feature_request_template.md # Feature request template
        pull_request_template.md # Pull request template
    contributing/
        info.md # Contributing page
    links/
        info.md # Links page

(back to top)

📝 Documentation

The Website documentation is provided by gitbook and can be discovered at url:

Java Patterns

To enable documentation serving at localhost you can run the following script

./scripts/build-docs.sh

otherwise, the next steps should be considered:

1) Install/upgrade pip command-line utility:

pip install --upgrade pip

or if you need to install pip for the first time:

wget --no-check-certificate https://bootstrap.pypa.io/get-pip.py
python get-pip.py

2) Install the mkdocs package using pip:

pip install mkdocs

or more conveniently for Windows subsystem:

python -m pip install mkdocs --quiet

or via provided software package manager tool:

brew install mkdocs     # macOS
sudo apt install mkdocs # Ubuntu
sudo yum install mkdocs # CentOS/RHEL

3) Install the material theme for the website:

python -m pip install mkdocs-material --quiet
python -m pip install markdown-include --quiet
...
(see requirements.txt)
...

4) Start a web server on your local machine at localhost, where you can see the entire website – with hot-reload when you save a change by running the following command:

python -m mkdocs build --clean --config-file mkdocs.yml
python -m mkdocs serve --verbose --dirtyreload

The site is served from the address specified in configuration file mkdocs.yml. The MkDocs default is localhost:8000, but the current configuration file sets it:

dev_addr: '0.0.0.0:8000'

The --dirtyreload option limits rebuilds to the changed page, which means changes to mkdocs.yml are not reflected. If you change mkdocs.yml, stop and restart python -m mkdocs serve --verbose --dirtyreload.

5) Deploy to GitHub pages:

python -m mkdocs --verbose gh-deploy --force --remote-branch gh-pages

5) Open up localhost in browser to get the default documentation homepage.

(back to top)

🧶 Kubernetes

Running k8s cluster with tilt command by acquiring k8s deployment configuration:

tilt up

Shutting down k8s cluster with provisioned resources removal:

tilt down --delete-namespaces

(back to top)

⏰ Statistics

(back to top)

📝 Versioning

The project uses SemVer for versioning. For the versions available, see the tags on this repository.

(back to top)

🌹 Authors

Java Patterns is maintained by the following GitHub team-members:

with community support please contact with us if you have some question or proposition.

(back to top)

💕 Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us (emoji key).

More on information on project contributions can be found at CHANGELOG.md.

This project follows the all-contributors specification. Contributions of any kind are welcome!

See also the list of contributors who participated in this project.

Java Design Patterns has experimental support for Gitpod, a pre-configured development environment that runs in your browser. To use Gitpod, click the button below and sign in with GitHub. Gitpod also offers a browser add-on, though it is not required.