Skip to content

Development notes

Not every portfolio piece needs to become a full case study

Using the different materials behind this site’s project cards, templates, and image galleries to decide what belongs in a case study: a finished screen is not a record of the process, and a demo link is not evidence of results.

林予晴
Published
  • Portfolio
  • Case studies
  • Content planning
  • Product storytelling

A screenshot, a demo, and a few technology tags are enough to start introducing a portfolio piece. Turning it into a full case study requires answers to other questions: why it was made, what constrained the choices, and what verifiable results remain.

Not every project has that material. You can look for what is missing or narrow the article’s scope. You cannot fill gaps with an undocumented story just because a case-study template has sections labeled “Challenges” and “Results.”

When organizing this site’s work and notes, I first decide what kind of content the material can support, then whether it warrants an article. A piece can stay on display without first acquiring a complete product-development narrative.

Project cards and case studies answer different questions

The development project cards on this site show a title, date, thumbnail, technology tags, and a demo link; some also link to source code. Design work and AIGC images appear in galleries. These are the presentation formats the pages currently provide. They do not mean that requirements interviews, decision records, or post-launch results have been documented for every piece.

A card helps readers quickly identify a project and decide whether to open it. A case study has to explain a choice: what problem existed, what conditions mattered, and why that approach was taken.

The same screen can appear in both, but it serves different purposes. On a card, it identifies the work. In a case study, it might explain information order or differences in interaction. If the body merely expands the card’s tags into longer sentences, the article gets longer without gaining evidence.

Start with what the existing material can support

This site’s project data includes single-page templates as well as work explicitly named as interface templates. Those names and the displayed content are a starting point for introducing the implementation scope. They do not establish that a project had a real client, live operational data, or a completed backend service.

An admin screen, for example, can support a discussion of information presentation. Whether login, saving, or a flow across multiple pages works requires a separate look at the implementation and actual operation. Even if a demo opens, the presence of that link alone does not justify claiming that every feature has been tested.

The same applies to image work. Existing images let readers see composition and presentation, but a design case study still needs a documented purpose, constraints, and trade-offs. A final image cannot establish an unrecorded proposal process, nor can a generated image be described as a client deliverable without evidence.

This article does not review every demo individually or judge the functionality of external projects that have not been inspected. The point is to understand the limits of the display material so you know what evidence to look for next.

Choose one decision you can explain

A full case study does not have to cover an entire product. If the surviving material only supports one question, focus on that question.

The following are suggestions for selecting material, not additions to the development history of this site’s projects:

Available material Content to consider What it does not establish on its own
Screens and a verifiable layout implementation An implementation note on a particular interface structure Improved efficiency for users
Before-and-after versions and documented trade-offs Why a flow or information order changed Business results from the redesign
Real inputs, transformation rules, and outputs A case study of a data-processing flow Support for every data format
A finished image without process records A presentation of the work and an explanation of the material A complete research, proposal, and iteration process

I start by writing one sentence: “Which decision will this article explain?” Then I look for material that supports it. If I cannot write that sentence, I do not rush to fit the piece into fixed sections for background, problem, solution, and results.

Sometimes the right form is a narrowly focused technical note rather than a product case study. Sometimes the work only needs a clear description. The content can be smaller, and its claims should be smaller too.

Results can be observable without being numerical

A lack of impact metrics does not mean there is nothing to write about. With real records, you can describe the output produced, the interaction path completed, or the limitations that remain.

But output and impact still need to stay separate. A site that can generate static pages has not necessarily improved its search ranking. A tool that completes one set of data transformations has not established how much time it saves in daily work. An interface that displays a chart has not necessarily verified the chart’s data source.

These are examples to guide judgment, not new measurements of this site’s work. When no numbers can be checked, stating the results actually confirmed is more useful than adding a plausible-looking percentage.

If even the result itself has not been rechecked, keep the piece as a display or clearly state that the article only discusses a particular part of the implementation. The evidence does not need to stretch to fit a case-study template.

Public disclosure needs a separate check

Having all the material does not necessarily make it suitable for publication. Before organizing it into an article, check whether the screens, data, people, and collaboration details fall within what can be shared.

If the article’s main judgment only makes sense with internal records that cannot be disclosed, narrow the question so it does not depend on those details, or postpone the article. Private conversations and internal handoff material cannot simply be treated as background the reader already knows.

Removing names does not make everything publishable. If you recreate illustrative data, label it clearly rather than letting an illustrative screen pass for a real result. This is a scope check before writing, not a ruling on permissions, contracts, or legal rights for any particular piece.

A good display can stand without a long case study

When selecting material, leave answers to four questions for each candidate: which decision needs explaining, what evidence can be made public, what judgment the reader can take away, and what material is still missing.

If all you have is the finished work, make its description accurate first. If you have one clearly documented part of the implementation, write about that part. Once the requirements, process, and results can all be checked, assess whether a full case study fits. This is an editorial sequence, not a ranking of the work’s quality.

The note on project cards and notes discusses what each entry point provides; the note on turning development records into methods discusses how to organize an article. This article adds an earlier selection step: not every portfolio piece has to enter the same narrative format.

Without new interviews, user research, or impact measurements, keeping a piece on display does not mean a case study has failed. The reason not to write it yet should be insufficient material or an unconfirmed scope, rather than covering those gaps with a complete story.