Wilson Mar bio photo

Wilson Mar


Email me Calendar Skype call

LinkedIn Twitter Gitter Instagram Youtube

Github Stackoverflow Pinterest

Example of yaml markup variables for Jekyll to generate HTML - a job description

US (English)   Español (Spanish)   Français (French)   Deutsch (German)   Italiano   Português   Cyrillic Russian   中文 (简体) Chinese (Simplified)   日本語 Japanese   한국어 Korean


This is an example of a job description for a Developer Advocate.

Using variables

This page is also an example of how page variables can be used in the markup text so that key words can be changed in one place and be applied to all instances in the document.

The author of this page added variables in the header at the top of the authoring file which is not presented to readers. Within the body of the article’s text is inserted developers. When Jekyll reads this markup to generates HTML, it substitutes the variable with the data value from the header.

{{ page.company }} is looking for a {{ page.role }} to join us in attracting the interest of {{ page.targets }} using {{ page.languages }} to use our {{ page.product }} along with {{ page.job_tools }}.

Values are obtained at the top of the page containing:

company: XYZ
product: Gizmo
role: Developer Advocate
job_type: SRE
team: marketing
travel_pct: 20%
passion: technology evangelism
bring: content and perspective 
certifications: AWS, Pragmatic Marketing
skill: presenter
expertise: product and customer
targets: developers
competencies: application servers, scripting, and network infrastructure
languages: Go, NodeJs, Python, C, Ruby, and Rust
clouds: Amazon (AWS), Azure, and Google
platforms: Kubernetes
job_tools: GitHub, Maven, Gradle, Groovy, 
colab_tools: Slack, Jira
document: use cases (solution briefs)
demo: best practices

CAUTION: Misspellings of keys would result in a compilation error that blocks all other page processing.

The result:

The generated job description

XYZ is looking for a Developer Advocate so we better attract the interest of developers using Go, NodeJs, Python, C, Ruby, and Rust to use Gizmo along with GitHub, Maven, Gradle, Groovy.

The successful candidate is an engaging communicator, passionate, and loves interacting with our partners, clients, and prospects.

You know the concerns, interests, demographics, and cultures of developers, and you have creative ideas around how we can connect deeply and effectively with them.

As a key member of our small, rapidly growing marketing team, you will be the face and voice of XYZ to developers.

You will be the go to person for telling our story to the market - on stage at events, during industry-wide webcasts, and in conference rooms at the largest companies.

This role would involve up to 20% travel.

As both a product and customer expert, you will also be the sales force’s key marketing contact to help develop effective account specific go-to-market strategies.

We’re seeking not only a great presenter but an excellent listener, who is curious about the needs and concerns of our prospects and customers.

You’ll be using Amazon (AWS), Azure, and Google where we run Kubernetes.

Responsibilities: Day in the life

Your key responsibilities toward building a following of passionate developers include the following during a day in the life:

  • Identify strategies and opportunities to bring content and perspective to both developers and executives who manage them.

  • Plan content and campaigns (with partners) that leverage time and expense to achieve the highest returns.

  • Analyze trend data in order to position XYZ as a thought leader.

  • Analyze new features and capabilities to present them as useful and compelling.

  • Seek out and write up use cases (solution briefs) to demonstrate best practices.

  • Publish blog posts and tutorials and speak at meetups and conferences to highlight best practices and offer fresh perspectives.

  • Champion users’ needs internally by providing invaluable feedback to the sales, product, and engineering teams.

  • Craft attention-getting yet informative posts in social networks and create blog and video content to attract and grow interest.

  • Use and create open source projects so developers can adopt the company’s offerings quicker and more confidently.

The ideal candidate

  • Has done a similar job before in this industry, with sharable examples of previous speaking opportunities, conference speaker feedback, and/or recorded webcast delivery.

  • Has built a visible online presence via social media, blogs, forums, GitHub repos and/or community involvement.

  • Experience as a current or former SRE with one or more apps published in an app marketplace (Google Play, Apple Store, Windows Store, Office Store, iTunes, etc.)

  • Ability to code demos in Go, NodeJs, Python, C, Ruby, and Rust.

  • Expertise using GitHub, Maven, Gradle, Groovy.

  • Familiarity using Slack, Jira.

  • Can confidently moderate discussions among technical and non-technical groups.

  • Passed AWS, Pragmatic Marketing certifications.

  • Has potential aspirations for marketing, business development, sales, or product leadership roles in the future.

Bonus points

You get bonus points if:

  • You are in love with the Gizmo product.

  • You are a tinkerer! Show us any personal projects you’ve worked on, GitHub projects you’ve forked, etc.

  • You are naturally inclined to provide unbelievable customer service and enjoy teaching and helping others.

  • Measurable competency with application servers, scripting, and network infrastructure.

  • Experience in a startup and growth-stage environments

  • Developed a “maturity model”.

What we offer

  • A unique opportunity to play a critical crossover technical/ business role at a high-growth company in a rapidly emerging open source infrastructure category.

  • The chance to say you “got in early” into one of the pioneers!

  • Equity
  • Matching 401(K) plans
  • 100% employer paid premiums for medical, dental, life insurance, disability
  • Flexible vacation - take time off when you need it

  • Free lunches, dinners, and fully stocked snacks & beverages
  • Commuter benefits for public transit and bicycle commuters
  • Shower facilities in the building
  • Wellness initiatives (incentive programs, fitness classes)
  • Free gym membership with shuttle service, onsite cardio gym, company organized and sponsored sports and leagues.
  • Free parking (We pay for parking tickets in San Francisco’s Mission District, too.)

  • Lounge areas with ping pong, foosball, pinball, and arcade games
  • Monthly happy hours
  • Company ski trips, boat parties, BBQs, happy hours, game nights … just to name a few!
  • Volunteer opportunities and extra PTO for community work.

  • Casual dress code

  • MacBook (16 GB, with 2 additional screens)
  • Employee development opportunities


BS in a STEM degree, SRE experience, ability to code in Go, NodeJs, Python, C, Ruby, and Rust, excellent written and presentations.

More on Technical Evanglism

This post is one of a series:

  1. Job Descriptions

  2. Evangelism dependencies
  3. Deliverables and Events Budgeting spreadsheet
  4. Evangelism Cost-Benefit analysis (Bang-for-the-buck comparion)

  5. Events and Conferences
  6. Calendar of Announcements
  7. Milestone events

  8. Social media
  9. Social media strategy
  10. Tweets
  11. Sentiment analysis (of favorable words or not)
  12. Responses to social media
  13. Tech Press mentions

  14. Competitive Comparisons (by analysts and others)
  15. Competitive Strategy
  16. Competitive Comparison Kit (for people to run for themselves)
  17. Objections, and how to handle them

  18. Target Customers
  19. Customer References
  20. Proof Points
  21. Email databases (User Acquisition)
  22. Remarketing of current or lapsed users

  23. Product websites
  24. Product wikis
  25. User Forums (Google, LinkedIn, Reddit, etc.)
  26. Surveys

  27. Product Roadmaps
  28. Release Schedule
  29. Tasks
  30. Issues

  31. environments for development, testing, demos, training, etc.
  32. Demo presentation scripts
  33. Beta activities
  34. Release Notes

  35. Tutorials
  36. Live event sign-up administration
  37. Webinars
  38. Video production capability
  39. Live Video Streaming

  40. Spiffs
  41. Hackathons
  42. Participating in Conferences
  43. Running Conferences
  44. Dynamic projections of tweets, etc.

  45. Recruitment follow-up