Sdk: No doc generated. (Linux) (Topic moved)

[Songbird0]

(I've moved my topic here, sorry for double post)
Hi !

While some hours, I'm trying to generate my project doc, but it don't work... (0 parsed files)
My pubspec.yaml:
name: random
dependencies:
js: ^0.3.0
intl: ^0.12.4
environment:
sdk: ">=1.16.0"

Do you know where is my error ? Or it's a bug ?

Thanks for advance !

Songbird.

[mit-mit]

Hi @Songbird0, can you include additional details on what command you are running to generate docs, and what your file layout looks like?

[Songbird0]

can you include additional details on what command you are running to generate docs

Sure.

My project skeleton:

├── myapp.dart
├── packages
├── pubspec.lock
└── pubspec.yaml

In myapp.dart file:

/// This is a dartdoc comment !
/// and another
class MyApp
{
    MyApp()
    {

    }
}

Next, I type the command dartdoc in my root directory (named 'random').
Result:

~/Documents/random$ dartdoc
Generating documentation for 'random' into /home/songbird/Documents/random/doc/api/

Parsed 0 files in 1.7 seconds.

documenting random
Documented 0 libraries in 2.0 seconds.

Success! Docs generated into /home/songbird/Documents/random/doc/api

My dart file hasn't been parsed, dartdoc not completed.

So, what I see when my browser display the index.html file:

Thanks for your help,

Songbird.

[mit-mit]

I believe dartdoc assumes that the library files are in a lib directory, @pq can you confirm?

Try to create your project using stagehand and use the default file structure it gives you (using stagehand package-simple) -- that should work.

[pq]

Yes. I think that's right. Looking at the docs, this doesn't seem well expressed though. Might benefit from emphasis?

cc @keertip.

[Songbird0]

It work ! :D
Thanks for your help, my documentation has been completed.

[pq]

Great to hear. We'll look at clarifying our tool docs.

Cheers!