In a visual portfolio, words act as the connective tissue that explains the significance of each project. Well‑crafted descriptions keep visitors engaged and improve SEO. Below are actionable tips derived from the Arriaga Archive’s writing approach.
Start With a Clear Hook
Open with a single sentence that answers the question: What problem did this project solve? Use active verbs and avoid jargon. Example: “We transformed an abandoned warehouse into a vibrant co‑working hub.”
Use the Two‑Column Format Effectively
When employing component pattern one, the left column often contains a bold title, while the right column holds the description. Keep the title under 8 words and capitalize each word for visual impact.
Employ Concise Paragraphs
Break content into 2‑3 short paragraphs. Each paragraph should cover a distinct aspect:
- Project scope and objectives.
- Key design decisions and tools used.
- Outcomes and measurable results.
Highlight Technical Details with Monospaced Text
The Arriaga Archive uses IBM Plex Mono for body copy, which naturally draws attention to technical terms. Embed code snippets, file formats, or software names in <code> tags to maintain typographic consistency.
Integrate Keywords Naturally
Identify 2‑3 primary keywords for each project (e.g., “responsive web design,” “sustainable architecture”). Incorporate them in headings and body text without forced repetition.
Include Call‑to‑Action (CTA)
End with a brief CTA encouraging deeper interaction: “Explore the full case study,” “Download the project brief,” or “Contact us for collaboration.”
Proofread for Tone and Voice
Maintain a conversational yet professional tone. Avoid first‑person plural unless the brand voice specifically calls for it. Use “we” sparingly to keep focus on the project impact.
SEO Best Practices
- Meta description (post excerpt) should be under 160 characters and include a primary keyword.
- Use
<h2>for subheadings that reflect secondary keywords. - Add
altattributes to all images describing the visual content with relevant keywords.
Example Description
Title: Sustainable Marketplace
Excerpt: A web platform that connects local artisans with eco‑conscious shoppers, built with responsive design and carbon‑offset hosting.
Body:
We partnered with GreenTech to develop a marketplace that emphasizes low‑impact design. Using React and Tailwind CSS, we created a fluid layout that adjusts to any screen size. The platform’s carbon‑offset hosting reduced emissions by 30% compared to traditional servers.
Key outcomes:
- 45% increase in user engagement within the first month.
- 20% reduction in bounce rate thanks to optimized load times.
Ready to explore the full case study? Click here.
Conclusion
By following these structured guidelines, each project entry becomes an informative, searchable, and engaging piece that strengthens the overall portfolio narrative.