Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve readme #2745

Merged
merged 5 commits into from
Aug 31, 2023
Merged

Improve readme #2745

merged 5 commits into from
Aug 31, 2023

Conversation

CSchoel
Copy link
Contributor

@CSchoel CSchoel commented Aug 19, 2023

During my work on #358, I noticed a few parts of the README_detailed.md that could be improved in my opinion. I didn't want to conflate this with the code and page changes, so I created a separate branch.

When I first read the README, I missed the part that mentioned the Makefile, so I thought it would make sense to make this more prominent and give a TLDR version for the hasty reader. 😉

In the more detailed description afterward, there was some confusion about where generated files would end up. I guess this has changed since the README was written, but wasn't updated here.

Finally, I was confused that not all the required files were in the build folder after generation, so I added the info that you need to copy the files from hugo into build before running Hugo.

Copy link
Member

@mbollmann mbollmann left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, that looks good to me!

I wonder to what extent we need to describe the "manual" build steps at all. In principle, everything should be doable through the Makefile, as the individual build steps should all have their own make target anyway. I guess that's another thing we could make clearer in the future.

Copy link
Member

@akoehn akoehn left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Forgot to submit my comments ...

README_detailed.md Show resolved Hide resolved
README_detailed.md Show resolved Hide resolved
Copy link
Member

@mjpost mjpost left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the edits!

@mjpost mjpost merged commit a4fdc7e into acl-org:master Aug 31, 2023
1 check passed
xinru1414 pushed a commit that referenced this pull request Aug 31, 2023
* updates readme regarding folder names
* adds quickstart info
* adds transitional text
@CSchoel CSchoel deleted the improve_readme branch September 5, 2023 19:56
anthology-assist added a commit that referenced this pull request Oct 13, 2023
* ingested jeptalnrecital volume coria.

* ingested jeptalnrecital volume rjc.

* ingested jeptalnrecital volume arts.

* ingested jeptalnrecital volume deft.

* Updated ingestion scripts with volume tag

* added missing volume attribute

* black

* Update metadata from Papers with Code

* CCL 2023 Ingestion (#2735)

* Updates to README (#2745)

* updates readme regarding folder names
* adds quickstart info
* adds transitional text

* Backlinked missing ACL workshops (#2720)

* Linked missing workshops from ACL
* Organized workshops in 2023.ws under their parent event with an XML comment
* Anthology code now skips comments when parsing

* TSAR 2022 fixes (#2363) (#2751)

* backlinked missing workshop from EMNLP 2022
* added DOIs

* ingested long.

* ingested short.

* ingested statement.

* ingested international.

* ingested volume demos.

* ingested volume proj.

* fixed \\ issue.

* updated one pdf.

---------

Co-authored-by: Matt Post <mattpost@microsoft.com>
Co-authored-by: acl-pwc-bot <94475230+acl-pwc-bot@users.noreply.github.com>
Co-authored-by: Christopher Schölzel <christopher.schoelzel@mailbox.org>
Co-authored-by: Matt Post <post@cs.jhu.edu>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants