9 ms·

The Overengineered Resume with Zola, JSON Resume, Weasyprint, and Nix (2023)

182 points by ahamez 2y ago

foreigner 2y ago
Can't we all just agree as an industry to use LinkedIn profiles and move on to more productive things? I know they're horrible but come on already.
- hirvi74 2y ago
  That is too pragmatic for an industry the pretends it values efficiency.
paultopia 2y ago
I love me an overengineered resume. I've been hacking on my academic cv as part of my personal website for years and years, with unholy stuff like live TeX libraries downloaded in the midst of a netlify CI process. Still needs some work on various formatting edge cases, but in case you're curious: https://github.com/paultopia/websiterevision2017 https://github.com/paultopia/websiterevision2017
syspec 2y ago
Am I missing something? Where it says "The Result", I don't see the result. Am I looking in the wrong place?
LarsDu88 2y ago
There is a much simpler approach to making a nice looking resume. Just use markdown > html > pdf using a custom css style sheet This is what I use for my resume: https://github.com/LarsDu/LarryDuMarkdownResume https://github.com/LarsDu/LarryDuMarkdownResume
mertysn 2y ago
I created my CV with React and Semantic UI since I was not satisfied with the amount of visual precision Word provides. The stack choice was due to personal ease of use, Semantic is probably an overkill. Recently, I started turning it into a template and added some documentation. The next step is to feed the data (experience, education) through JSON so it's easier for others. It is automated to the point of generating a new preview GIF every time I push to master. I still manually hit CTRL+P to get the PDF though, it feels faster than implementing automation. I'll hopefully do a Show HN in the future but until then, here is a demo on GitHub Pages: https://mrtysn.github.io/cv/ https://mrtysn.github.io/cv/
alexey-salmin 2y ago
But the results looks... very bad?
cprecioso 2y ago
There's also Manfred's MAC schema for describing resumes https://github.com/getmanfred/mac https://github.com/getmanfred/mac
kthartic 2y ago
Scrolled to "The Result" section only to see... nothing? Would've been nice to see the resulting resume
- erk__ 2y ago
  It is linked in the introduction: https://ktema.org/Resume-David-Reed.pdf https://ktema.org/Resume-David-Reed.pdf
  - kthartic 2y ago
    Thanks. Maybe I'm nitpicking but a link in the middle of a sentence isn't the best UX considering it's the main subject matter of the article. Easy to miss
    - strangelove026 2y ago
      I missed it also
Ezhik 2y ago
Now that's "resume-driven development". And hey, overdesigned or not, it's a resume that ended up on the front page of Hacker News, making it all worth it given what a resume is supposed to do.
- jddj 2y ago
  Absolutely, great advertising. If only I knew what an internal enablement initiative or customer acceleration solution was.
knallfrosch 2y ago
As web dev, I migrated from TeX to svelte + Chrome's Print-to-PDF. I've found that splitting data and representation is not as feasible as it sounds. You add a job and suddenly your CV doesn't fit on a page anymore, and cutting details from previous jobs isn't enough. So you change the layout, ever so slightly, because the data changed. And version control? Nice for building, but it's not like you'll ever go back in time anyway. What's nice though is defining the data and then trying different layouts to see what works.
mih 2y ago
Reminds me of : https://xkcd.com/1205/ https://xkcd.com/1205/ and https://xkcd.com/1319/ https://xkcd.com/1319/
jkitching 2y ago
I put together an HTML+CSS template for authoring one-page documents that will be printed out (or saved as PDF): https://github.com/jkitching/1pager-printable-html https://github.com/jkitching/1pager-printable-html It can be used for creating a PDF locally, or the HTML file can also be viewed directly in the browser - both should look identical. When I was looking into different ways of converting HTML into PDF, everything I came across did a pretty bad job at correctly supporting CSS layouts and positioning. So I ended up just using headless Chrome for printing. Perhaps WeasyPrint does a better job with CSS support?
bionsystem 2y ago
I have a resume in latex, all I have to do is change a couple lines every now and then and run the default latex pipeline, all of it directly from gitlab. It worked on the first time I tried and every time since then, it produces a pdf which I can then download and send. I noticed the container they run uses nix too, which is nice although I don't care about it as long as it works. I could add signing of the pdf maybe some day for fun. What's great with this approach is how little hassle there is and nothing to install, nowhere, and produces the same clean resume I've used for over a decade (but needed to install a thousand things I could never remember from one computer to another).
cm2187 2y ago
I wish there was a standard format for resume that was universally used. Every HR website requires you to upload a resume to apply, then tries to extract the various experiences and details automatically, invariably fucks it up completely, and you end up having to spend 20 minutes to correct it manually. Unless they treat this exercise as a form of captcha…
- guilherme-puida 2y ago
  In Brazil we have Lattes (https://pt.wikipedia.org/wiki/Plataforma_Lattes https://pt.wikipedia.org/wiki/Plataforma_Lattes). The English translation does not mention it, but one of it's most useful features is a centralized resume platform. It's quite nice, but mostly used by people in academia and government-adjacent areas.
- lionkor 2y ago
  EU has the Europass, I just use that.
lelanthran 2y ago
The linked resume is a poor example of the process. It's neither visually pleasing nor is it more easily readable than other CVs that I have seen. It's fine for a CV to be visually ugly as long as its readable, or visually attractive in spite of being less readable. You can't fail at both dimensions. If you're really happy with a CV that looks and reads like this, save yourself all the effort and make a RTF document instead.
- deepspace 2y ago
  The bullets to the left of the titles make my eyes bleed.
- pcrh 2y ago
  Agreed. It also has irrelevant fluff within the very first section, "I'm passionate about delivering products....I strive to center compassion..." etc.
lucumo 2y ago
Automating your resume is a bit of a rite of passage for new software engineers. It just feels like a stupid repetitive task. I've found that I change job summaries so often, that automating it was a net negative in time spent on the thing. So now I just do the same as the digitally challenged: copy a Word file to "resume (DATE).docx" and change the contents as needed. My younger self would be surprised, and slightly annoyed, at how often I use the "dumb" solutions for problems.
- ivanjermakov 2y ago
  Except that it is a great learning experience. Data driven resume was my introduction to LaTeX and I had a great time building it.
  - lucumo 2y ago
    LaTeX itself is sort of a rite of passage. It's slightly more useful, because the mathematical side of academia runs on it. There's a bunch of template you get for free by doing what everybody else is doing. The corporate world has those too, but for Word, because that's what they use. There's this subconscious believe that something that has a steep learning curve will make things easier later on. That is not always true. If you want stuff that is more complex than normal, Word and LaTeX are about equally as annoying, if nobody solved it for you (templates, Google). LaTeX is just harder for the easy stuff too. Doing my resume was the last thing I did in LaTeX, not the first. Doing anything in LaTeX just stopped being useful when the recipients didn't recognize Computer Modern anymore.
- d3vmax 2y ago
  Yea, no need of over-engineering.
hitchstory 2y ago
I did something similar but with my phone, the android orgzly app, termux, jinja2 and latex. I cribbed a CV template from overleaf and put some jinja2 in it to take the content from CV note in my note taking app: https://hitchdev.com/orji/using/latex-cv/ https://hitchdev.com/orji/using/latex-cv/ With termux I can then hit a button to run a script and it will instantly generate a pretty PDF using latex from an orgzly note and fire off an android share intent. The nice thing about this set up was that if a recruiter called me while I was out and wanted a CV quickly with a couple of tweaks made I could just do it on my note taking app and email an updated PDF in a few seconds. In theory I could easily change the style of the CV but in practice I haven't felt the need to touch it in years.
sondr3 2y ago
I also over-engineered how I generate my CV[1], but went the opposite direction by using Dhall to create JSON and LaTeX files that I use to create a PDF and GraphQL API in Rust for it, automatically deployed via CI/CD to a VPS and a tagged GitHub release. It was a lot of fun to make, but is so over-engineered I hardly want to touch it anymore :) [1]: https://github.com/sondr3/cv-aas https://github.com/sondr3/cv-aas
elAhmo 2y ago
It is definitely overengineered and, unfortunately, outdated, as the most recent position in the resume and about page do not match. A lot of effort for something that is not accurate and obviously not used to apply for jobs, which is the purpose of a resume in most cases. A simple file (Word doc, Numbers, Google Doc) that receives a change every few years and is exported as a PDF seems to do the task better.
datadeft 2y ago
Typst a way simpler approach to this: https://typst.app/ https://typst.app/
asimpletune 2y ago
You don't see many people who went to St. John's college. If the author or any St. John alumni are reading this, I'd love to hear what you thought about the experience.
Xcelerate 2y ago
I think the presentation of a resume is much less important than the content. It’s interesting that sourcers and recruiters make most of the decisions about who gets to the interview stage (particularly in a down market), yet they are the least qualified to assess the capabilities of the candidate of everyone in the whole process. Despite that, their assessment of a candidate’s resume has an outsized influence on the candidate’s outcome. When you have 1,000 resumes from laid off software engineers from FANG companies that all look mostly the same, how do you decide who to call? I’ve been thinking lately that an interesting project might be to look for publicly available resumes of people who have recently accepted new jobs within the tech industry and compare their resumes against those of people who have been looking for a new job for a while. The comparison would be qualitative if only a few resumes are available or perhaps quantitative (i.e., a classification model) if many are available. Recruiters are not looking for the same signals as hiring managers, and since I’m not a recruiter, I would really like to know exactly what it is that they are looking for. As an example of this kind of discrepancy that caught me totally off-guard, I was slightly below the “years of experience” requirement on a particular job posting that seemed to match my background perfectly. The recruiter I was talking to had reached out about another job posting where I did meet the YoE requirement, but I said the other posting was a significantly better fit for my skills and experience. The recruiter replied that the YoE requirement was not negotiable, so I was put onto the interview loop for the much less applicable role because of this arbitrary and narrowly missed line in the sand (and of course I failed that interview, wasting both my time and theirs). A hiring manager would care less about years in seat and more about capability. That such a YoE requirement might be used as a hard filter when scanning resumes caught me by surprise—I had previously sent out plenty of resumes where I narrowly missed the YoE requirement, and in retrospect, my application was probably discarded immediately while using up the “quota” of how many times I could apply to that company. These sorts of insights from the recruiting world would be great to know in advance from the candidate’s perspective.
- Terretta 2y ago
  Unfortunately you either (a) need to craft your resume to work for all types of recruiters and all types of hiring managers*, or (b) carefully pick the type of firm and hiring managers and recruiting team you want to work with, then tailor the CV to appeal to them and get rejected by organizations that would annoy you. The choice depends on your “need” for the next job. * Examples of opposites in resume-reading personas: Many roles open vs. single role open. In-house versus outsourced recruiting. Contentful versus process recruiting. Technical versus MBA managers. Surface impression forming versus depth reading. Credential seeking versus competence recognizing.
Terretta 2y ago
Unsolicited advice: If you're going to that trouble, finish the swing. The final product here is BAD. The person reading the resume doesn't know it's automated so no credit points for that, and it looks like a person didn't pay attention to basic detail. This does you no good, it hurts you. Example glitches: The contact row dropping LinkedIn to next line. The ragged bullets hanging to the left of the left margin relative to headlines. The dates not right aligned. The too-large font making it take ALL of two pages for just a decade. These things do get judged at a glance when someone's looking at lots of PDFs. Also, just because a resume goes into an ATS doesn't mean the hiring manager isn't looking at the original PDF. Usually the ATS surfaces/sorts applicants but one reads the original PDF or Word doc anyway, because the ATS interpretation is often unreliable on its own. All that said... One idea to counter the above advice is either in italics under the contact line or in a clear footer, put a colophon or imprint saying: This PDF was auto-generated from my job history data, blogged about the automation here: https://full.web.link/resume-blog-post https://full.web.link/resume-blog-post But still, exhibit a higher bar for the end product. Engineers that fall in love with over-engineering without regard for the output and "end user experience" are everywhere, and a problem. Engineers that produce above-the-bar output end users appreciate, while ironically over-engineering, with full tongue in cheek recognition of the over-engineering, are rare.
- faitswulff 2y ago
  On the other hand, they just managed to get their resume in front of thousands of people.
  - benreesman 2y ago
    http://stevehanov.ca/blog/?id=56 http://stevehanov.ca/blog/?id=56
    - blauditore 2y ago
      I feel personally attacked
- deleted 2y ago
  [deleted]
deleted 2y ago
[deleted]
altgans 2y ago
Interesting approach. I am currently looking for jobs and went the 'career coaching' route for my CV. I did a few iterations with my coach until I got my current result (ideally I had a link): I first looked at Canva templates, but apparently nowadays you are supposed to do black/white and no fancy designs for ATS readability. Then I tried it with Google Docs b/w resumee template, which kinda got me to write actual skills. Then I approached the coach, got her template and iterated, and then I also added some rules from here (https://principiae.be/pdfs/ECV-1.01.pdf https://principiae.be/pdfs/ECV-1.01.pdf). I also involved ChatGPT to analyze job postings and to get the mix of keywords in my resumme right. Tools like https://tagcrowd.com/ https://tagcrowd.com/ also help with that. For example, I am targeting 'IT analyst' roles, and it does make sense that I have the word 'analysis' a few times in my CV. E: mine is basically structured the following way Name Title Summary 3x5 ATS keywords/skills specific to my profile and role last ten years, also written in a way that 'gamifies' ATS: 'Year, worked as ROLE at Company, did XYZ' --page 2-- Education (degree + grades) Skills Training Languages Some more IT skills (programming languages, project management, ...) E2: I obviously have no idea what I am doing, but I got three interview proposals for 10 applications, so I guess 30%.
BaculumMeumEst 2y ago
The only thing you should spend time on with your CV is the content. The ROI on tweaking the look and feel is very low. Aesthetics are not what people care about, unless your resume is so hideous that it gets thrown out.
- codetrotter 2y ago
  My CV is a LibreOffice Writer document with no styling added. A “boring” short black and white non-interactive document that I export to PDF. It has my name, contact info, a list of recent work history, and mention of some of the technologies that I work with. Last time I was applying for jobs, two years ago, I got an interview and eventually a job offer from the company I most wanted to work for among the ones I’d been submitting applications to. I’ve been there since. I agree with you. And I think that any attempt to make the document look flashy would only have worked against me. At least when applying to the kind of jobs that I prefer – backend software engineering work.
  - lbrito 2y ago
    Same. LibreOffice exported to PDF. Also I cram everything into one page while keeping things readable. Being concise is an important skill. Personally I find it ridiculous people with a few years of experience and 3+ pages. I have 12 years of industry experience and don't feel the need for that second page yet.
jefc1111 2y ago
Mine is also automated, but a lot more lightweight. I - like OP - use JSON Resume [1]. Besides that I just have a Github Action which creates a PDF and also updates a web-based version [2] hosted in AWS S3. My favourite thing about this setup is that if I want to make a small change I can just log in to Github and commit a quick edit in the repo [3] through Github's web-based UI A new PDF is generated and the web-based version being updates automatically. [1] https://jsonresume.org/ https://jsonresume.org/ [2] http://geoff-clayton-cv.s3-website-eu-west-1.amazonaws.com/ http://geoff-clayton-cv.s3-website-eu-west-1.amazonaws.com/ [3] https://github.com/jefc1111/cv/tree/master https://github.com/jefc1111/cv/tree/master
- thomasfromcdnjs 2y ago
  I've made some improvements to the JR registry recently (still looks horrible) But you can just go to https://registry.jsonresume.org https://registry.jsonresume.org, login with github, create the gist, and then your resume is automatically "deployed". And it is stored on github gist, so data is yours, and has revisions as a nice added benefit.
- Scubabear68 2y ago
  Your CV is a lot closer visually to what I was expecting from the original post. Varied font sizes and use of different regions on the page. Easy to take in at a glance.
  - jefc1111 2y ago
    Thanks! I am a fan of seeing one page CVs.
  - elbear 2y ago
    Yeah, it looks quite nice.
- glumreaper 2y ago
  That format is really nice! I regret to say it but I found what looks like a typo - you've got "automcomplete" where I think you mean "autocomplete". I hope this helps improve your resume.
ChrisMarshallNY 2y ago
This reminds me a bit of that animated Flash résumé that some young animator did, back in the day. It received quite a bit of attention (both good and bad). It was basically a cartoon version of him, walking through his various life accomplishments. It was well-done, and all, but I found it a bit annoying. Also, it was Flash.
domenkozar 2y ago
It would be bring less complexity using https://devenv.sh/ https://devenv.sh/ to provide the tooling :-)
DEADMINCEDOS 2y ago
I don't know that this is the right way to solve the resume 'problem' - I think LaTeX is a far superior choice, yet the author pretty much dimissed it as a possibility. For me personally, I found LaTeX to be the perfect solution. I have my resume tex setup so I can set toggles to define what gets output. E.g. applying for a manager position, I might keep it brief and more technical. The resume is modular and can be updated by updating external txt files and not the LaTeX itself. It looks nice, is always consistent, has nice links, etc. It's optimized for all the ATS nonsense it inevitably gets run through, it generates a PDF, and I've made it near impossible for recruiters to copy and paste and repurpose it without retyping much of it, and I have a tone of tech tricks in their like invisible text that automated systems might see. If LaTeX itself is sufficient, I can't imagine needing to add in something like Nix and a webserver or how that would be better in any way.
- sensanaty 2y ago
  I've never tried LaTeX, but I've built my last few resumes with plain old HTML+CSS then saving as PDF. Works pretty great and is insanely simple to upkeep/modify
- IshKebab 2y ago
  I have yet to see a really good LaTeX CV. I guess it is possible but in my experience LaTeX just isn't designed for that and gives boring-looking results.
  - taeric 2y ago
    I have yet to see an impressive resume from someone that wasn't boring in layout. Worse, I have seen very few resumes that were not boring in looks that were attached to a good candidate. :(
    - IshKebab 2y ago
      > I have seen very few resumes that were not boring in looks that were attached to a good candidate I have seen many. You might be misinterpreting "boring". I don't mean that CVs should be like a Flash website. I mean they should look good typographically and not just like an instruction manual for a washing machine. I wish I'd saved some of the best ones, but take a look at some of these: https://www.beamjobs.com/resumes/programmer-resume-examples https://www.beamjobs.com/resumes/programmer-resume-examples Ignoring the content, they are almost all far superior typographically to the example in this article.
ajxs 2y ago
I love the idea, but the thing that keeps me from over-engineering my own resume is the number of times recruiters have asked for a copy in Word format, so they can strip out all the identifying features. Lots of large companies mandated this practice to combat bias when screening resumes. This irks me because I'm really just trying to get the Github profile and personal site URLs in my resume in front of technical people.
Communitivity 2y ago
Cool project. That said, I never send the same resume to everyone. I tailor a resume for each job I apply to. This doesn't mean leaving off positions or lying. It does mean taking the work done in a position and giving it a slant toward the target job. For example, let's say I created a web app that shows a sales dashboard, with stats visualization, from raw daily sales data. Job 1 (applying for Front-End) - Created monthly sales dashboard web site using React, MaterialUI, SASS, Node, Riak, and D3. Dashboard provided grid-based summary over individual weeks, months, and years. It also provided configurable line graphs and pie charts for various sales metrics. Data pre-processing done with Sci-Kit. Later added sales prediction using Machine Learning. Job 2 (applying for Data Analysis) - Analyzed raw daily sales data to determine data cleansing needed, and created tool pipeline using Python NumPy, SciKit, and scikit-learn. Integrated pipeline into Riak data source ingest, and then built sales dashboard web site to visualize the data. Provided ML model for sales prediction built with scikit-learn, with XX parameters. Model achieved YY accuracy with only a ZZ mean error. Same work in both, but I highlight the tasks most relevant to the target job. Other thoughts are that Latex is a good way to get a well laid out PDF resume (PDF is not the web, you should have two versions of your resume), and I agree with other commenters - the final product needs more polish if it was actually going to be used to produce a resume to send in (I think it's fine as a proof of concept though).
blikdak 2y ago
OMg really hope you got 10x jobs that workflow.
deleted 2y ago
[deleted]
Scubabear68 2y ago
The blog set me up for a really gorgeous typeset resume with lines in the intro like “More visual flair and typesetting control”. With that expectation set, the end product was severely underwhelming. The visual flare is non-existent.
nickorlow 2y ago
I started doing something less over-engineered last year. It uses LaTeX with a CD pipeline and I think it's is a good way to do resumes. Every time I push mine, the one linked on my personal website is updated to the new version. The diffing and version pinning is nice. Throughout intern application season I usually make updates to my resume and it's nice to be able to easily go back to the version of the resume that I applied with whenever I get a callback from a company. Mine: https://github.com/nickorlow/resume https://github.com/nickorlow/resume Website with link pointing to latest pdf: https://nickorlow.com https://nickorlow.com I also do something similar with cheat-sheets for classes. Using git for collaboration it is really nice: https://github.com/nickorlow/cs-331-cheatsheet https://github.com/nickorlow/cs-331-cheatsheet I do like the concept in the article of separating the data from the presentation.
natertux 2y ago
I had the same idea sometime ago. Not sure if you can say that it was over engineered or not but I used the following: * Frontend framework : Next.js / React (Functional components with React Hooks) * Rendering : Static Site Generation * Programming language : Typescript * CI/CD : Github actions * Unit test : jest * Design : SASS / Responsive design * Data validation : AJV / JSON Schema / Joi * Infrastructure : Cloudflare pages / Terraform * Package management: Yarn * Linting & Formatting : ESLint / StyleLint / Prettier * Pattern matching : ts-pattern * CSS framework : react-bootstrap * Monorepo : nx * PDF generation : jspdf * Contact form : web3forms * Captcha : hCaptcha I am quite happy with the final output : https://www.remikeat.com https://www.remikeat.com It would pull the data from https://data.remikeat.com/resume.en.json https://data.remikeat.com/resume.en.json https://data.remikeat.com/resume.jp.json https://data.remikeat.com/resume.jp.json https://data.remikeat.com/resume.fr.json https://data.remikeat.com/resume.fr.json So I can just update the JSON and the webpage will update itself. Also as the PDF is generated locally, the PDF also get updated automatically. And I didn't know there was a JSON standard for resume. Maybe, I should migrate the format I designed to this open standard. Ultimately, I wanted to add a portfolio section, where I would show some of my projects like https://stackl.remikeat.com https://stackl.remikeat.com which is a stack language interpreter written in Ocaml and compiled to js with js_of_ocaml.
1oooqooq 2y ago
"over engineered resume" oh boy. wait until you see europass standard. appetizer: it's a pdf, with embedded xml, with html snipet field values.
fasteddie31003 2y ago
I'm working on hacking the job application process by having LLMs take your base resume and tailor it for each job application. I'd love your feedback https://customizedresumes.com https://customizedresumes.com . I've been A/B testing by applying for jobs with only my base resume compared to an AI-customized resume. It's roughly a 2x higher response rate with the customized resume.
mnw21cam 2y ago
This page is utterly confusing. Is it about a CV? I don't see what is being resumed.
jdonaldson 2y ago
Dropping a link/endorsement for quarto : https://quarto.org/ https://quarto.org/ It's a static site/document generator that supports bibliographies, jupyter notebooks, and good old fashioned markdown. It works well for complex academic resumes and CV's, as well as blogs and library documentation. I use a template for my website : https://jjd.io/ https://jjd.io/ github repo : https://github.com/jdonaldson/jjd.io https://github.com/jdonaldson/jjd.io Also, if anyone has any positive/negative comments on my site, let er rip! I'm still working on it.
- deleted 2y ago
  [deleted]
nico 2y ago
Shameless plug: once you are done building your resume, copy and paste the text into CommandJobs[1] to automatically match your experience with job listings and get a filtered list of the best ones for you [1]: https://github.com/nicobrenner/commandjobs https://github.com/nicobrenner/commandjobs
- deleted 2y ago
  [deleted]
whalesalad 2y ago
Afaik modern resume parsers prefer .docx to .pdf. Some won't even accept a PDF.
- argiopetech 2y ago
  The only way to win is not to play.
- systems 2y ago
  Yea, looks like a big miss that he is not producing a docx file but then, maybe he dont want employers who only accept docx resume files
microflash 2y ago
And here I'm, writing the resume in markdown using Obsidian, slapping some custom CSS until it looks good and hitting Export to PDF.
- deleted 2y ago
  [deleted]
tristor 2y ago
The overengineering here produced a poor result. I have found a lot of success using the pandoc_resume project, which is literally just a content item written in Markdown, formatted into different outputs using a LaTeX template via `pandoc`. With this, I output a PDF that looks great, and output HTML which I put in as a non-touched file in my static site generator, and it works very well.

182 points by ahamez 2y ago

Can't we all just agree as an industry to use LinkedIn profiles and move on to more productive things? I know they're horrible but come on already.

hirvi74 2y ago
That is too pragmatic for an industry the pretends it values efficiency.

paultopia 2y ago

I love me an overengineered resume. I've been hacking on my academic cv as part of my personal website for years and years, with unholy stuff like live TeX libraries downloaded in the midst of a netlify CI process. Still needs some work on various formatting edge cases, but in case you're curious: https://github.com/paultopia/websiterevision2017 https://github.com/paultopia/websiterevision2017

syspec 2y ago

Am I missing something? Where it says "The Result", I don't see the result. Am I looking in the wrong place?

LarsDu88 2y ago

There is a much simpler approach to making a nice looking resume. Just use markdown > html > pdf using a custom css style sheet This is what I use for my resume: https://github.com/LarsDu/LarryDuMarkdownResume https://github.com/LarsDu/LarryDuMarkdownResume

mertysn 2y ago

I created my CV with React and Semantic UI since I was not satisfied with the amount of visual precision Word provides. The stack choice was due to personal ease of use, Semantic is probably an overkill. Recently, I started turning it into a template and added some documentation. The next step is to feed the data (experience, education) through JSON so it's easier for others. It is automated to the point of generating a new preview GIF every time I push to master. I still manually hit CTRL+P to get the PDF though, it feels faster than implementing automation. I'll hopefully do a Show HN in the future but until then, here is a demo on GitHub Pages: https://mrtysn.github.io/cv/ https://mrtysn.github.io/cv/

alexey-salmin 2y ago

But the results looks... very bad?

cprecioso 2y ago

There's also Manfred's MAC schema for describing resumes https://github.com/getmanfred/mac https://github.com/getmanfred/mac

kthartic 2y ago

Scrolled to "The Result" section only to see... nothing? Would've been nice to see the resulting resume

erk__ 2y ago
It is linked in the introduction: https://ktema.org/Resume-David-Reed.pdf https://ktema.org/Resume-David-Reed.pdf
- kthartic 2y ago
  Thanks. Maybe I'm nitpicking but a link in the middle of a sentence isn't the best UX considering it's the main subject matter of the article. Easy to miss
  - strangelove026 2y ago
    I missed it also

Ezhik 2y ago

Now that's "resume-driven development". And hey, overdesigned or not, it's a resume that ended up on the front page of Hacker News, making it all worth it given what a resume is supposed to do.

jddj 2y ago
Absolutely, great advertising. If only I knew what an internal enablement initiative or customer acceleration solution was.

knallfrosch 2y ago

As web dev, I migrated from TeX to svelte + Chrome's Print-to-PDF. I've found that splitting data and representation is not as feasible as it sounds. You add a job and suddenly your CV doesn't fit on a page anymore, and cutting details from previous jobs isn't enough. So you change the layout, ever so slightly, because the data changed. And version control? Nice for building, but it's not like you'll ever go back in time anyway. What's nice though is defining the data and then trying different layouts to see what works.

mih 2y ago

Reminds me of : https://xkcd.com/1205/ https://xkcd.com/1205/ and https://xkcd.com/1319/ https://xkcd.com/1319/

jkitching 2y ago

I put together an HTML+CSS template for authoring one-page documents that will be printed out (or saved as PDF): https://github.com/jkitching/1pager-printable-html https://github.com/jkitching/1pager-printable-html It can be used for creating a PDF locally, or the HTML file can also be viewed directly in the browser - both should look identical. When I was looking into different ways of converting HTML into PDF, everything I came across did a pretty bad job at correctly supporting CSS layouts and positioning. So I ended up just using headless Chrome for printing. Perhaps WeasyPrint does a better job with CSS support?

bionsystem 2y ago

I have a resume in latex, all I have to do is change a couple lines every now and then and run the default latex pipeline, all of it directly from gitlab. It worked on the first time I tried and every time since then, it produces a pdf which I can then download and send. I noticed the container they run uses nix too, which is nice although I don't care about it as long as it works. I could add signing of the pdf maybe some day for fun. What's great with this approach is how little hassle there is and nothing to install, nowhere, and produces the same clean resume I've used for over a decade (but needed to install a thousand things I could never remember from one computer to another).

cm2187 2y ago

I wish there was a standard format for resume that was universally used. Every HR website requires you to upload a resume to apply, then tries to extract the various experiences and details automatically, invariably fucks it up completely, and you end up having to spend 20 minutes to correct it manually. Unless they treat this exercise as a form of captcha…

guilherme-puida 2y ago
In Brazil we have Lattes (https://pt.wikipedia.org/wiki/Plataforma_Lattes https://pt.wikipedia.org/wiki/Plataforma_Lattes). The English translation does not mention it, but one of it's most useful features is a centralized resume platform. It's quite nice, but mostly used by people in academia and government-adjacent areas.
lionkor 2y ago
EU has the Europass, I just use that.

lelanthran 2y ago

The linked resume is a poor example of the process. It's neither visually pleasing nor is it more easily readable than other CVs that I have seen. It's fine for a CV to be visually ugly as long as its readable, or visually attractive in spite of being less readable. You can't fail at both dimensions. If you're really happy with a CV that looks and reads like this, save yourself all the effort and make a RTF document instead.

deepspace 2y ago
The bullets to the left of the titles make my eyes bleed.
pcrh 2y ago
Agreed. It also has irrelevant fluff within the very first section, "I'm passionate about delivering products....I strive to center compassion..." etc.

lucumo 2y ago

Automating your resume is a bit of a rite of passage for new software engineers. It just feels like a stupid repetitive task. I've found that I change job summaries so often, that automating it was a net negative in time spent on the thing. So now I just do the same as the digitally challenged: copy a Word file to "resume (DATE).docx" and change the contents as needed. My younger self would be surprised, and slightly annoyed, at how often I use the "dumb" solutions for problems.

ivanjermakov 2y ago
Except that it is a great learning experience. Data driven resume was my introduction to LaTeX and I had a great time building it.
- lucumo 2y ago
  LaTeX itself is sort of a rite of passage. It's slightly more useful, because the mathematical side of academia runs on it. There's a bunch of template you get for free by doing what everybody else is doing. The corporate world has those too, but for Word, because that's what they use. There's this subconscious believe that something that has a steep learning curve will make things easier later on. That is not always true. If you want stuff that is more complex than normal, Word and LaTeX are about equally as annoying, if nobody solved it for you (templates, Google). LaTeX is just harder for the easy stuff too. Doing my resume was the last thing I did in LaTeX, not the first. Doing anything in LaTeX just stopped being useful when the recipients didn't recognize Computer Modern anymore.
d3vmax 2y ago
Yea, no need of over-engineering.

hitchstory 2y ago

I did something similar but with my phone, the android orgzly app, termux, jinja2 and latex. I cribbed a CV template from overleaf and put some jinja2 in it to take the content from CV note in my note taking app: https://hitchdev.com/orji/using/latex-cv/ https://hitchdev.com/orji/using/latex-cv/ With termux I can then hit a button to run a script and it will instantly generate a pretty PDF using latex from an orgzly note and fire off an android share intent. The nice thing about this set up was that if a recruiter called me while I was out and wanted a CV quickly with a couple of tweaks made I could just do it on my note taking app and email an updated PDF in a few seconds. In theory I could easily change the style of the CV but in practice I haven't felt the need to touch it in years.

sondr3 2y ago

I also over-engineered how I generate my CV[1], but went the opposite direction by using Dhall to create JSON and LaTeX files that I use to create a PDF and GraphQL API in Rust for it, automatically deployed via CI/CD to a VPS and a tagged GitHub release. It was a lot of fun to make, but is so over-engineered I hardly want to touch it anymore :) [1]: https://github.com/sondr3/cv-aas https://github.com/sondr3/cv-aas

elAhmo 2y ago

It is definitely overengineered and, unfortunately, outdated, as the most recent position in the resume and about page do not match. A lot of effort for something that is not accurate and obviously not used to apply for jobs, which is the purpose of a resume in most cases. A simple file (Word doc, Numbers, Google Doc) that receives a change every few years and is exported as a PDF seems to do the task better.

datadeft 2y ago

Typst a way simpler approach to this: https://typst.app/ https://typst.app/

asimpletune 2y ago

You don't see many people who went to St. John's college. If the author or any St. John alumni are reading this, I'd love to hear what you thought about the experience.

Xcelerate 2y ago

I think the presentation of a resume is much less important than the content. It’s interesting that sourcers and recruiters make most of the decisions about who gets to the interview stage (particularly in a down market), yet they are the least qualified to assess the capabilities of the candidate of everyone in the whole process. Despite that, their assessment of a candidate’s resume has an outsized influence on the candidate’s outcome. When you have 1,000 resumes from laid off software engineers from FANG companies that all look mostly the same, how do you decide who to call? I’ve been thinking lately that an interesting project might be to look for publicly available resumes of people who have recently accepted new jobs within the tech industry and compare their resumes against those of people who have been looking for a new job for a while. The comparison would be qualitative if only a few resumes are available or perhaps quantitative (i.e., a classification model) if many are available. Recruiters are not looking for the same signals as hiring managers, and since I’m not a recruiter, I would really like to know exactly what it is that they are looking for. As an example of this kind of discrepancy that caught me totally off-guard, I was slightly below the “years of experience” requirement on a particular job posting that seemed to match my background perfectly. The recruiter I was talking to had reached out about another job posting where I did meet the YoE requirement, but I said the other posting was a significantly better fit for my skills and experience. The recruiter replied that the YoE requirement was not negotiable, so I was put onto the interview loop for the much less applicable role because of this arbitrary and narrowly missed line in the sand (and of course I failed that interview, wasting both my time and theirs). A hiring manager would care less about years in seat and more about capability. That such a YoE requirement might be used as a hard filter when scanning resumes caught me by surprise—I had previously sent out plenty of resumes where I narrowly missed the YoE requirement, and in retrospect, my application was probably discarded immediately while using up the “quota” of how many times I could apply to that company. These sorts of insights from the recruiting world would be great to know in advance from the candidate’s perspective.

Terretta 2y ago
Unfortunately you either (a) need to craft your resume to work for all types of recruiters and all types of hiring managers*, or (b) carefully pick the type of firm and hiring managers and recruiting team you want to work with, then tailor the CV to appeal to them and get rejected by organizations that would annoy you. The choice depends on your “need” for the next job. * Examples of opposites in resume-reading personas: Many roles open vs. single role open. In-house versus outsourced recruiting. Contentful versus process recruiting. Technical versus MBA managers. Surface impression forming versus depth reading. Credential seeking versus competence recognizing.

Terretta 2y ago

Unsolicited advice: If you're going to that trouble, finish the swing. The final product here is BAD. The person reading the resume doesn't know it's automated so no credit points for that, and it looks like a person didn't pay attention to basic detail. This does you no good, it hurts you. Example glitches: The contact row dropping LinkedIn to next line. The ragged bullets hanging to the left of the left margin relative to headlines. The dates not right aligned. The too-large font making it take ALL of two pages for just a decade. These things do get judged at a glance when someone's looking at lots of PDFs. Also, just because a resume goes into an ATS doesn't mean the hiring manager isn't looking at the original PDF. Usually the ATS surfaces/sorts applicants but one reads the original PDF or Word doc anyway, because the ATS interpretation is often unreliable on its own. All that said... One idea to counter the above advice is either in italics under the contact line or in a clear footer, put a colophon or imprint saying: This PDF was auto-generated from my job history data, blogged about the automation here: https://full.web.link/resume-blog-post https://full.web.link/resume-blog-post But still, exhibit a higher bar for the end product. Engineers that fall in love with over-engineering without regard for the output and "end user experience" are everywhere, and a problem. Engineers that produce above-the-bar output end users appreciate, while ironically over-engineering, with full tongue in cheek recognition of the over-engineering, are rare.

faitswulff 2y ago
On the other hand, they just managed to get their resume in front of thousands of people.
- benreesman 2y ago
  http://stevehanov.ca/blog/?id=56 http://stevehanov.ca/blog/?id=56
  - blauditore 2y ago
    I feel personally attacked
deleted 2y ago
[deleted]

deleted 2y ago

[deleted]

altgans 2y ago

Interesting approach. I am currently looking for jobs and went the 'career coaching' route for my CV. I did a few iterations with my coach until I got my current result (ideally I had a link): I first looked at Canva templates, but apparently nowadays you are supposed to do black/white and no fancy designs for ATS readability. Then I tried it with Google Docs b/w resumee template, which kinda got me to write actual skills. Then I approached the coach, got her template and iterated, and then I also added some rules from here (https://principiae.be/pdfs/ECV-1.01.pdf https://principiae.be/pdfs/ECV-1.01.pdf). I also involved ChatGPT to analyze job postings and to get the mix of keywords in my resumme right. Tools like https://tagcrowd.com/ https://tagcrowd.com/ also help with that. For example, I am targeting 'IT analyst' roles, and it does make sense that I have the word 'analysis' a few times in my CV. E: mine is basically structured the following way Name Title Summary 3x5 ATS keywords/skills specific to my profile and role last ten years, also written in a way that 'gamifies' ATS: 'Year, worked as ROLE at Company, did XYZ' --page 2-- Education (degree + grades) Skills Training Languages Some more IT skills (programming languages, project management, ...) E2: I obviously have no idea what I am doing, but I got three interview proposals for 10 applications, so I guess 30%.

BaculumMeumEst 2y ago

The only thing you should spend time on with your CV is the content. The ROI on tweaking the look and feel is very low. Aesthetics are not what people care about, unless your resume is so hideous that it gets thrown out.

codetrotter 2y ago
My CV is a LibreOffice Writer document with no styling added. A “boring” short black and white non-interactive document that I export to PDF. It has my name, contact info, a list of recent work history, and mention of some of the technologies that I work with. Last time I was applying for jobs, two years ago, I got an interview and eventually a job offer from the company I most wanted to work for among the ones I’d been submitting applications to. I’ve been there since. I agree with you. And I think that any attempt to make the document look flashy would only have worked against me. At least when applying to the kind of jobs that I prefer – backend software engineering work.
- lbrito 2y ago
  Same. LibreOffice exported to PDF. Also I cram everything into one page while keeping things readable. Being concise is an important skill. Personally I find it ridiculous people with a few years of experience and 3+ pages. I have 12 years of industry experience and don't feel the need for that second page yet.

jefc1111 2y ago

Mine is also automated, but a lot more lightweight. I - like OP - use JSON Resume [1]. Besides that I just have a Github Action which creates a PDF and also updates a web-based version [2] hosted in AWS S3. My favourite thing about this setup is that if I want to make a small change I can just log in to Github and commit a quick edit in the repo [3] through Github's web-based UI A new PDF is generated and the web-based version being updates automatically. [1] https://jsonresume.org/ https://jsonresume.org/ [2] http://geoff-clayton-cv.s3-website-eu-west-1.amazonaws.com/ http://geoff-clayton-cv.s3-website-eu-west-1.amazonaws.com/ [3] https://github.com/jefc1111/cv/tree/master https://github.com/jefc1111/cv/tree/master

thomasfromcdnjs 2y ago
I've made some improvements to the JR registry recently (still looks horrible) But you can just go to https://registry.jsonresume.org https://registry.jsonresume.org, login with github, create the gist, and then your resume is automatically "deployed". And it is stored on github gist, so data is yours, and has revisions as a nice added benefit.
Scubabear68 2y ago
Your CV is a lot closer visually to what I was expecting from the original post. Varied font sizes and use of different regions on the page. Easy to take in at a glance.
- jefc1111 2y ago
  Thanks! I am a fan of seeing one page CVs.
- elbear 2y ago
  Yeah, it looks quite nice.
glumreaper 2y ago
That format is really nice! I regret to say it but I found what looks like a typo - you've got "automcomplete" where I think you mean "autocomplete". I hope this helps improve your resume.

ChrisMarshallNY 2y ago

This reminds me a bit of that animated Flash résumé that some young animator did, back in the day. It received quite a bit of attention (both good and bad). It was basically a cartoon version of him, walking through his various life accomplishments. It was well-done, and all, but I found it a bit annoying. Also, it was Flash.

domenkozar 2y ago

It would be bring less complexity using https://devenv.sh/ https://devenv.sh/ to provide the tooling :-)

DEADMINCEDOS 2y ago

I don't know that this is the right way to solve the resume 'problem' - I think LaTeX is a far superior choice, yet the author pretty much dimissed it as a possibility. For me personally, I found LaTeX to be the perfect solution. I have my resume tex setup so I can set toggles to define what gets output. E.g. applying for a manager position, I might keep it brief and more technical. The resume is modular and can be updated by updating external txt files and not the LaTeX itself. It looks nice, is always consistent, has nice links, etc. It's optimized for all the ATS nonsense it inevitably gets run through, it generates a PDF, and I've made it near impossible for recruiters to copy and paste and repurpose it without retyping much of it, and I have a tone of tech tricks in their like invisible text that automated systems might see. If LaTeX itself is sufficient, I can't imagine needing to add in something like Nix and a webserver or how that would be better in any way.

sensanaty 2y ago
I've never tried LaTeX, but I've built my last few resumes with plain old HTML+CSS then saving as PDF. Works pretty great and is insanely simple to upkeep/modify
IshKebab 2y ago
I have yet to see a really good LaTeX CV. I guess it is possible but in my experience LaTeX just isn't designed for that and gives boring-looking results.
- taeric 2y ago
  I have yet to see an impressive resume from someone that wasn't boring in layout. Worse, I have seen very few resumes that were not boring in looks that were attached to a good candidate. :(
  - IshKebab 2y ago
    > I have seen very few resumes that were not boring in looks that were attached to a good candidate I have seen many. You might be misinterpreting "boring". I don't mean that CVs should be like a Flash website. I mean they should look good typographically and not just like an instruction manual for a washing machine. I wish I'd saved some of the best ones, but take a look at some of these: https://www.beamjobs.com/resumes/programmer-resume-examples https://www.beamjobs.com/resumes/programmer-resume-examples Ignoring the content, they are almost all far superior typographically to the example in this article.

ajxs 2y ago

I love the idea, but the thing that keeps me from over-engineering my own resume is the number of times recruiters have asked for a copy in Word format, so they can strip out all the identifying features. Lots of large companies mandated this practice to combat bias when screening resumes. This irks me because I'm really just trying to get the Github profile and personal site URLs in my resume in front of technical people.

Communitivity 2y ago

Cool project. That said, I never send the same resume to everyone. I tailor a resume for each job I apply to. This doesn't mean leaving off positions or lying. It does mean taking the work done in a position and giving it a slant toward the target job. For example, let's say I created a web app that shows a sales dashboard, with stats visualization, from raw daily sales data. Job 1 (applying for Front-End) - Created monthly sales dashboard web site using React, MaterialUI, SASS, Node, Riak, and D3. Dashboard provided grid-based summary over individual weeks, months, and years. It also provided configurable line graphs and pie charts for various sales metrics. Data pre-processing done with Sci-Kit. Later added sales prediction using Machine Learning. Job 2 (applying for Data Analysis) - Analyzed raw daily sales data to determine data cleansing needed, and created tool pipeline using Python NumPy, SciKit, and scikit-learn. Integrated pipeline into Riak data source ingest, and then built sales dashboard web site to visualize the data. Provided ML model for sales prediction built with scikit-learn, with XX parameters. Model achieved YY accuracy with only a ZZ mean error. Same work in both, but I highlight the tasks most relevant to the target job. Other thoughts are that Latex is a good way to get a well laid out PDF resume (PDF is not the web, you should have two versions of your resume), and I agree with other commenters - the final product needs more polish if it was actually going to be used to produce a resume to send in (I think it's fine as a proof of concept though).

blikdak 2y ago

OMg really hope you got 10x jobs that workflow.

deleted 2y ago

[deleted]

Scubabear68 2y ago

The blog set me up for a really gorgeous typeset resume with lines in the intro like “More visual flair and typesetting control”. With that expectation set, the end product was severely underwhelming. The visual flare is non-existent.

nickorlow 2y ago

I started doing something less over-engineered last year. It uses LaTeX with a CD pipeline and I think it's is a good way to do resumes. Every time I push mine, the one linked on my personal website is updated to the new version. The diffing and version pinning is nice. Throughout intern application season I usually make updates to my resume and it's nice to be able to easily go back to the version of the resume that I applied with whenever I get a callback from a company. Mine: https://github.com/nickorlow/resume https://github.com/nickorlow/resume Website with link pointing to latest pdf: https://nickorlow.com https://nickorlow.com I also do something similar with cheat-sheets for classes. Using git for collaboration it is really nice: https://github.com/nickorlow/cs-331-cheatsheet https://github.com/nickorlow/cs-331-cheatsheet I do like the concept in the article of separating the data from the presentation.

natertux 2y ago

I had the same idea sometime ago. Not sure if you can say that it was over engineered or not but I used the following: * Frontend framework : Next.js / React (Functional components with React Hooks) * Rendering : Static Site Generation * Programming language : Typescript * CI/CD : Github actions * Unit test : jest * Design : SASS / Responsive design * Data validation : AJV / JSON Schema / Joi * Infrastructure : Cloudflare pages / Terraform * Package management: Yarn * Linting & Formatting : ESLint / StyleLint / Prettier * Pattern matching : ts-pattern * CSS framework : react-bootstrap * Monorepo : nx * PDF generation : jspdf * Contact form : web3forms * Captcha : hCaptcha I am quite happy with the final output : https://www.remikeat.com https://www.remikeat.com It would pull the data from https://data.remikeat.com/resume.en.json https://data.remikeat.com/resume.en.json https://data.remikeat.com/resume.jp.json https://data.remikeat.com/resume.jp.json https://data.remikeat.com/resume.fr.json https://data.remikeat.com/resume.fr.json So I can just update the JSON and the webpage will update itself. Also as the PDF is generated locally, the PDF also get updated automatically. And I didn't know there was a JSON standard for resume. Maybe, I should migrate the format I designed to this open standard. Ultimately, I wanted to add a portfolio section, where I would show some of my projects like https://stackl.remikeat.com https://stackl.remikeat.com which is a stack language interpreter written in Ocaml and compiled to js with js_of_ocaml.

1oooqooq 2y ago

"over engineered resume" oh boy. wait until you see europass standard. appetizer: it's a pdf, with embedded xml, with html snipet field values.

fasteddie31003 2y ago

I'm working on hacking the job application process by having LLMs take your base resume and tailor it for each job application. I'd love your feedback https://customizedresumes.com https://customizedresumes.com . I've been A/B testing by applying for jobs with only my base resume compared to an AI-customized resume. It's roughly a 2x higher response rate with the customized resume.

mnw21cam 2y ago

This page is utterly confusing. Is it about a CV? I don't see what is being resumed.

jdonaldson 2y ago

Dropping a link/endorsement for quarto : https://quarto.org/ https://quarto.org/ It's a static site/document generator that supports bibliographies, jupyter notebooks, and good old fashioned markdown. It works well for complex academic resumes and CV's, as well as blogs and library documentation. I use a template for my website : https://jjd.io/ https://jjd.io/ github repo : https://github.com/jdonaldson/jjd.io https://github.com/jdonaldson/jjd.io Also, if anyone has any positive/negative comments on my site, let er rip! I'm still working on it.

deleted 2y ago
[deleted]

nico 2y ago

Shameless plug: once you are done building your resume, copy and paste the text into CommandJobs[1] to automatically match your experience with job listings and get a filtered list of the best ones for you [1]: https://github.com/nicobrenner/commandjobs https://github.com/nicobrenner/commandjobs

deleted 2y ago
[deleted]

whalesalad 2y ago

Afaik modern resume parsers prefer .docx to .pdf. Some won't even accept a PDF.

argiopetech 2y ago
The only way to win is not to play.
systems 2y ago
Yea, looks like a big miss that he is not producing a docx file but then, maybe he dont want employers who only accept docx resume files

microflash 2y ago

And here I'm, writing the resume in markdown using Obsidian, slapping some custom CSS until it looks good and hitting Export to PDF.

deleted 2y ago
[deleted]

tristor 2y ago

The overengineering here produced a poor result. I have found a lot of success using the pandoc_resume project, which is literally just a content item written in Markdown, formatted into different outputs using a LaTeX template via `pandoc`. With this, I output a PDF that looks great, and output HTML which I put in as a non-touched file in my static site generator, and it works very well.