This repository seeks to build on the lessons learned from Horoscope. As such, its goal is to continually, incrementally, and iteratively improve the business so we can increasingly focus on the things that matter most while maximizing our flow.
This means that someone should be able to come here with an idea or suggestion and...
- Put it through a standardized vetting, prioritization and refinement process
- End up with small, actionable and connected tasks that can be advanced by a team slowly and methodically over some time frame
- Make contributions into a predefined and obvious structure
- Have their contributions automatically deployed to the places where they have the most impact
- Improve Tandem by removing repetition, variables and confusion from our work
Before you begin make sure you...
- Understand where we are coming from and the problems this repo attempts to solve
- Understand the entire process for improving Tandem
- Have all the tools you need to contribute to this repo
- Have a decent idea about how Lando works
- Understand how to contribute code to it
- Understand how to QA and deploy said code
You can easily get relevant web properties eg the docs and website running locally.
# Clone this repo
git clone [email protected]:thinktandem/tandem.git
# Start it up
cd tandem
lando start
# Get a helpful list of all your lando commands
landotl;dr: lando tandem-blog:generate && lando show:containers
All blog posts are markdown files with front matter for SEO. You can use the command lando tandem-blog:generate to scaffold out a blog post template for you. The command prompts for the relevent information and creates the markdown file in the
site/blog directory for you. Here is an example run of the command:
gff ~/code/tandem/tandem
(tandem-blog-generate) └─ ∴ lando tandem-blog:generate
? Post title? How to Drupal Real Good
? Post summary? From starting your Drupal dev to advanced migrations.
? Written by? John Ouellet
? Choose your location: Sarasota
? Tags? John Ouellet, User Experience., Development.
_ __ _ __ __ __
/ |/ /__ _ __ ___ ___ __(_)__/ /__ / / ___ ____ / / ___ ___ ___
/ / -_) |/|/ / / _ `/ // / / _ / -_) / _ \/ _ `(_-< / _ \/ -_) -_) _ \_ _ _
/_/|_/\__/|__,__/ \_, /\_,_/_/\_,_/\__/ /_//_/\_,_/___/ /_.__/\__/\__/_//_(_|_|_)
/___/
_____ __ ____
/ ___/______ ___ _/ /____ ___/ / /
/ /__/ __/ -_) _ `/ __/ -_) _ /_/
\___/_/ \__/\_,_/\__/\__/\_,_(_)
Make sure you have run lando start to get the docs running locally.
Oh... and here are some vitals about your new content:
FILEPATH /home/gff/code/tandem/tandem/site/blog/2020-10-08-how-to-drupal-real-good.md
TITLE How to Drupal Real Good
SUMMARY From starting your Drupal dev to advanced migrations.
ID johno
AUTHOR John Ouellet
PIC /images/people/john-sm.jpg
LOCATION Sarasota
DATE 2020-10-08
PARSEDTAGS - johno
- ux
- development You can then open the file in your favorite text editor and write your post.
In the course of writing your post you may want to call attention to certain pieces of information. The Tandem Blog uses vuepress containers to achieve these callouts. You can get a list of them with the command lando show:containers. This command will list the available containers/callouts and when you select one give you the copy and pasteable syntax to drop into your blog post. Here is an example run:
gff ~/code/tandem/tandem
(tandem-blog-generate) └─ ∴ lando show:containers
? Choose a container danger
::: danger <optional title>
content for the danger container
:::Happy blogging!
# Run the markdown linter
lando test