denoland / denoland/docs

Feedback: /examples/fresh_tutorial/ - Needs Improvement

Open
#3,400 0 comments 0 reactions 0 assignees View on GitHub
feedback needs-improvement
Dominant language
TypeScript
Stars
204
Forks
385
Avg merge
14h 49m
Merged PRs (30d)
7

Description

## Documentation Feedback

**Path:** [/examples/fresh_tutorial/](https://docs.deno.com/examples/fresh_tutorial/)
**Helpful:** No ❌

**Feedback:**
> I'm new to Deno and Fresh, and this tutorial doesn't work due to changes in the framework when it comes to making the dinosaur related changes. I get a "Not Found" error which seems to be a Vite or Fresh error, as it does not match the "Dinosaur Not Found" error message in the file-based route.

I'm noting that https://github.com/denoland/tutorial-with-fresh seems to implement the same demo and uses a different routing directory structure, with some caveats:

- The `[dinosaur].tsx` file still refers to `import { PageProps } from "$fresh/server.ts"`, which VSCode's flags as with the error `Import "$fresh/server.ts" not a dependency and not in import map from "file:///Users/[path-to]/tutorial-with-fresh/routes/dinosaurs/[dinosaur].tsx"` As far as I can tell, the `$` prefix isn't a special import thing; it is confusing that the `deno.json` file doesn't refer to it. A remnant from an earlier version? Deprecated but still supported?

---
*This issue was automatically created from the documentation feedback system.*

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with /examples/fresh_tutorial/ and the routes/dinosaurs/[dinosaur].tsx example, then compare its routing and imports with the referenced tutorial-with-fresh repository. Check deno.json and the $fresh/server.ts import while reproducing the Not Found behavior. Done means the documented dinosaur changes work and the tutorial's expected error message appears.

Written by the indexing model from the issue text.

Assessment

Tech stack
deno, typescript
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.