eo icon indicating copy to clipboard operation
eo copied to clipboard

the structure of EO directories is not clear

Open mximp opened this issue 3 years ago • 18 comments

Currently the process is described in EO maven plugin. It would be good to extend the description with the input/output folders structure for each step.

mximp avatar Jun 27 '22 12:06 mximp

@yegor256 do you find this appropriate?

mximp avatar Jun 27 '22 12:06 mximp

@mximp yes, definitely, would be nice to extent the README

yegor256 avatar Jun 27 '22 12:06 yegor256

@Graur fix this please (or delegate)

yegor256 avatar Aug 23 '22 19:08 yegor256

@levBagryansky please, help to improve README.md file

Graur avatar Aug 31 '22 10:08 Graur

@levBagryansky It would nice to have description of target/eo folder structure as well as what files are consumed/produced by each compilation step.

mximp avatar Aug 31 '22 10:08 mximp

@mximp so I need to imrove README.md in eo/eo-parser? How can I understand what is going on there?

levBagryansky avatar Aug 31 '22 15:08 levBagryansky

@levBagryansky I'd say eo-maven-plugin/readme.md. You could run compilation, check target/eo/ and find how it's populated/used in the plugin code.

mximp avatar Sep 01 '22 07:09 mximp

@mximp maybe it would be better to leave a link to the post to avoid repeating?

levBagryansky avatar Nov 10 '22 09:11 levBagryansky

@levBagryansky The post explains what the phases are but doesn't specify exact input and output. I believe some addition is required. I've tried to accumulate the info here as another blog post: https://github.com/mximp/news.eolang.org/commit/cc01abcc9a81143de3156d353aacd11db6bdce05. But the format is not very readable. Maybe you could think of another representation.

mximp avatar Nov 10 '22 11:11 mximp

@levBagryansky What's up with this issue?

Graur avatar Nov 14 '22 08:11 Graur

@mximp we still have this issue?

yegor256 avatar Mar 05 '23 05:03 yegor256

@Graur anything left here?

mximp avatar Mar 06 '23 07:03 mximp

@mximp @yegor256 Yes, we still have this issue @MikhailLipanin Can you help us here?

Graur avatar Mar 06 '23 10:03 Graur

@Graur Do we still need to solve that?

volodya-lombrozo avatar Mar 23 '23 08:03 volodya-lombrozo

@volodya-lombrozo I believe we should ask @mximp about it. Since we have short description in eo-maven-plugin/README.md. But is it enough?

Graur avatar Mar 23 '23 08:03 Graur

@Graur @volodya-lombrozo The idea was to add more detailed information about actions on files during compilation. The attempt was made here, but as I mentioned it's quite unreadable.

We could at least add a folder structure of EO plugin here: https://github.com/objectionary/eo/tree/master/eo-maven-plugin/README.md.

mximp avatar Mar 23 '23 11:03 mximp

@Graur I can take care of it.

volodya-lombrozo avatar Mar 23 '23 11:03 volodya-lombrozo

@volodya-lombrozo Sure, go ahead

Graur avatar Mar 23 '23 11:03 Graur