minor documentation improvement - closes #7602

[michael-spengler]

just a minor thing but it might help many devs to understand why some modules use deps.ts and some don't.

[CLAassistant]

All committers have signed the CLA.

[kitsonk]

You need to run ./tools/format.py on this (yeah, even markdown is linted 😄 )

[Skillz4Killz]

Maybe this is a good chance to bring up whether it should be added to the documentation about discouraging users from export from mod.ts

export * from "dep url/mod.ts"

You might be importing like 1000 different things when u only want a few things. Kinda like the npm problem where people started splitting up packages.
lodash/x
lodash/y

This allowed them to only have the parts they wanted to be imported instead of 10k things. Eventually you will get dependencies that have dependencies and you are back to the old node_modules system of having tons of unused imports.

Deno is awesome, because it allows you to pick & choose what you want for maximum efficiency.

export { stuff, that, you, need, only } from "dep url/specific url"

Which of the following would you recommend to someone?

export { delay } from "https://deno.land/std@0.67.0/async/delay.ts";

export * from "https://deno.land/std@0.67.0/async/mod.ts"

// Imagine if the lib actually had a main mod.ts file like what most libs are doing
export * from "https://deno.land/std@0.67.0/mod.ts"

[nayeemrmn]

Ref #6196 (review).

[michael-spengler]

./tools/format.py

Can anybody let me know what I missed here - I'm not so much into Python - rather a TypeScript guy :)

[lucacasonato]

@michael-spengler You have to use python 2 for now. See #3294

[michael-spengler]

@michael-spengler You have to use python 2 for now. See #3294

still figuring things out :)

[lucacasonato]

Did you clone submodules? git submodule update --init --recursive

[michael-spengler]

git submodule update --init --recursive

Thank you @lucacasonato for your patience and sorry for not having checked this properly earlier: https://github.com/denoland/deno/blob/master/docs/contributing/building_from_source.md#cloning-the-repository

After git clone --recurse-submodules https://github.com/michael-spengler/deno.git michael-deno I ran it now and it formatted the .md file --> got stuck a bit later - don't know if this is relevant for this PR --> will anyhow look into it further - curiosity :)

[lucacasonato]

Formatting worked 👍

That issue happens because you don't have rust, cargo, or rustfmt installed.

[michael-spengler]

Formatting worked 👍

That issue happens because you don't have rust, cargo, or rustfmt installed.

just doing so - installing ...

feeling like a Deno insider already :)

I guess the PR is ready to merge - let me know if anything is open here.