Skip to content

Commit

Permalink
Documentation updates (#1273)
Browse files Browse the repository at this point in the history
* Updated list of volunteers, removed very old sponsors
* Removed defunct front page link to submit presentations (closes #1401)
* Changed ingestion instructions to point to a Github issue
* Updated link to copyright PDF
* Updated Anthology ID information
* Reorganized some blog-style links under `posts/`
* Minor corrections to install documentation
  • Loading branch information
mjpost authored Feb 22, 2022
1 parent 8500a12 commit b665348
Show file tree
Hide file tree
Showing 14 changed files with 103 additions and 114 deletions.
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/file-a-correction.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ name: File a Correction
about: Correcting paper data in the Anthology
title: Correction to Anthology ID XXX
labels: correction
assignees: mjpost
assignees: xinru1414

---

Expand Down
3 changes: 3 additions & 0 deletions README_detailed.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,9 @@ To build the anthology, the packages listed in
If this doesn't enable the C bindings, make sure you have Cython installed,
then try rebuilding pyyaml again.

You also need to install "jing", an XML schema checker. if you are using Homebrew on OS X, you can install
this with `brew install jing-trang`.

### Step 1: Prepare the data for site generation

The data sources for the Anthology currently reside in the [`data/`](data/)
Expand Down
4 changes: 0 additions & 4 deletions hugo/content/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,3 @@ css_container: container-fluid

<!-- To disable printing a date for the MOTD, set the "date" field above to some
value before 2019. -->

The Anthology can archive your poster or presentation!
Please submit them in PDF format by [filling out this form](https://forms.office.com/Pages/ResponsePage.aspx?id=DQSIkWdsW0yxEjajBLZtrQAAAAAAAAAAAAMAABqTSThUN0I2VEdZMTk4Sks3S042MVkxUEZQUVdOUS4u).
Attachments will be distributed under the terms of the [CC-BY-4.0 license](https://creativecommons.org/licenses/by/4.0/).
2 changes: 1 addition & 1 deletion hugo/content/faq/volunteer.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,4 @@ We welcome your contributions!
In fact, since the Anthology is run entirely on volunteer energy, we need them.
The best way to contribute is to browse our [Github issues](https://github.com/acl-org/acl-anthology/issues) page (we suggest starting with the ["help wanted"](https://github.com/acl-org/acl-anthology/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) tag, and see what needs to be done that overlaps with your interests or skills.
Please also feel free to email the director, [email protected].
You might also be interested in our [call for volunteers]({{< relref "/info/volunteer.md" >}}).
You might also be interested in our [developer documentation]({{< relref "/info/development.md" >}}).
56 changes: 32 additions & 24 deletions hugo/content/info/contrib.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,16 @@
Title: Information for Submitters
linktitle: Submitting
subtitle: General information on submitting proceedings to the ACL Anthology (for event chairs)
date: "2020-10-30"
date: "2021-04-18"
---

This page contains general information about submitting the proceedings of a conference to the ACL Anthology.
(For information about the complete conference management process, particularly for ACL conference publications chairs, please refer to [the official documentation](https://acl-org.github.io/ACLPUB/).)
It is intended for publication chairs of main conferences and standalone events, who have the responsibility of delivering the proceedings for all main conference and workshop volumes to the Anthology director.
Chairs of workshops attached to a larger conference should also read this page, but should work through their main conference publication chair instead of directly with the Anthology.

Please note that chairs of workshops colocated with a larger conference should work through their conference publication chair instead of directly with the Anthology.

### Overview of the Submission Process

Please note the following important dates.
Expand Down Expand Up @@ -45,44 +47,50 @@ Please note the following important dates.
</tbody>
</table>




### Register your meeting

If you are a conference publications chair, you must register your intention to submit your proceedings.
This step requires you to send (a) the complete list of volumes that will be published in the Anthology (main conference volumes and workshops) and (b) the desired publication date.
This information should be assembled in a spreadsheet and then commmunicated to [the Anthology Director](mailto:[email protected]) in a single email.
Please do this as early as possible, ideally well before the submission deadline.
An template for this spreadsheet [can be found here](https://docs.google.com/spreadsheets/d/13F1XhnT4PsiN-ZXcpv6QUp5A2qlr6-W9MoDgCkBOw9w/edit#gid=0).
Your proceedings will be due no later than **two weeks** prior to this negotiated date.

This information should be submitted to us [via a Github issue](https://github.com/acl-org/acl-anthology/issues/new?assignees=mjpost&labels=ingestion&template=ingestion-request.md&title=Ingestion+request)
**Please do this as early as possible**, ideally well before the submission deadline.
This will allow us to do a quick sanity check of the metadata.
As noted above, if you are the chair of a workshop that is colocated with a larger event, please work with your main conference publication chair instead of directly with the Anthology.

The following information in the spreadsheet is especially important:
Your Github issue should contain the following information for each volume.

- **Venue identifiers**. Each venue (conference or workshop) has a venue identifier.
- **Venue identifier**. Each venue (conference or workshop) has a [venue identifier]({{< relref "ids.md" >}}).
Its basic form is the conference acronym, such as ACL, NAACL, JEP/TALN/RECITAL, and so on.
A [slugified](https://en.wikipedia.org/wiki/Clean_URL#Slug) version of this acronym, containing only numerals and lowercase ASCII letters, is used in the URL for the venue's page on the Anthology (e.g., [ACL → acl](https://aclanthology.org/venues/acl), [JEP/TALN/RECITAL → jeptalnrecital](https://aclanthology.org/venues/jeptalnrecital)), and also forms a component of the [Anthology ID]({{< relref "ids.md" >}}).
For existing venues, be sure to look up [the venue's existing identifier](https://aclanthology.org/venues/).
New venues must have their venue identifier confirmed by the Anthology director.
Note: a common mistake is to include the year in the venue identifier, e.g., ACL2020 (perhaps in part because Softconf often uses this).
New venues must have their venue identifier confirmed by the Anthology director (see subsection below).
Note: a common mistake is to include the year in the venue identifier, e.g., ACL2020.
This confuses a *meeting* of a venue with the venue itself.
The identifier should not have the year or meeting number in it.
- **Venue name**. Each venue has a name.
These names are attached to the venue identifier and stored in [our database](https://github.com/acl-org/acl-anthology/blob/master/data/yaml/venues.yaml).
If your venue is new, please enter the venue name.
Note: similar to the caveat about about the venue identifier, this is the name of the venue, not a particular meeting of the venue.
When submitting a new venue to the Anthology, please make sure *not* to put the year or meeting number in the venue name.
- **Volume titles**. These are the titles of the volumes that will be published, e.g., *Proceedings of the...*.
- **Volume title**. This is the title of the volume book that will be published, e.g., *Proceedings of the...*.
We recommend you choose a name consistent with your prior years' volumes.
The full titles should not contain abbreviations, except parenthetically.
The full title should not contain abbreviations, except parenthetically.
For example, "Proceedings of EMNLP 2019" is not a good title, but "Proceedings of the 2019 Meeting of the Conference on Empirical Methods in Natural Language Processing (EMNLP)" is a great one.
If you have sub-volumes (e.g., long papers, short papers, demonstrations, tutorial abstracts), we suggest you append them after the full volume name.
If you have sub-volumes (e.g., long papers, short papers, demonstrations, tutorial abstracts), we suggest you append descriptors after the full volume name.
For example, "Proceedings of the 2019 Meeting of the Conference on Empirical Methods in Natural Language Processing (EMNLP): Tutorial Abstracts".
You should also seek consistency with the names of your volumes from prior years.
You may find [this naming guide](https://docs.google.com/document/d/1-4I8w-ckyy3oF2XMbkjAaq14EOyWSoSUW0dpCTtprm8/edit?usp=sharing) helpful.
But above all, you should also seek consistency with the names of your volumes from prior years.

If you are chairing a meeting attached as a satellite of a main conference (e.g., ACL or EMNLP), please work with the main conference publication chair, rather than directly with the Anthology staff.

#### New venues

If your venue is appearing for the first time in the Anthology, we need to assign it a venue identifier, as described above.
You can choose one yourself, but it will require confirmation from the Anthology director.
If you are submitting a new venue, please be sure to also include the following information:

By default, the publication of papers associated with an event in the Anthology will be on the first day of the event (inclusive of workshops or tutorials).
If you prefer to have it published on a different date, please inform us when you register.
- **Venue name**. Each venue has a name.
These names are attached to the venue identifier and stored in [our database](https://github.com/acl-org/acl-anthology/blob/master/data/yaml/venues.yaml).
If your venue is new, please enter the venue name.
Note: similar to the caveat about about the venue identifier, this is the name of the venue, not a particular meeting of the venue.
When submitting a new venue to the Anthology, please make sure *not* to put the year or meeting number in the venue name.
- **Website**. The website of the venue.
Ideally this is a website of the venue itself (e.g., [https://naacl.org](https://naacl.org)), and not a particular meeting of the venue.

### Submit your data

Expand All @@ -102,7 +110,7 @@ If you are using the START system, this process is handled as part of the camera

Otherwise, for copyright transfers, please use the form at:

+ https://github.com/acl-org/ACLPUB/blob/master/doc/authors/ACL-copyright-form.pdf
+ https://github.com/acl-org/ACLPUB/blob/master/templates/copyright/acl-copyright-transfer-2021.pdf

Forms should be signed by authors and saved using the ACL Anthology identifiers as names.
Please place these into a folder (e.g., `copyright-transfers/P11-1001.pdf`) and then deliver them in bulk to the Anthology Editor when submitting the proceedings.
Expand Down
6 changes: 3 additions & 3 deletions hugo/content/info/corrections.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,13 @@
Title: Requesting Corrections
linktitle: Corrections
subtitle: How to submit corrections to the Anthology
date: "2021-10-05"
date: 2021-11-11
---

### Types of corrections

The staff of the ACL Anthology can process requests for both many types of corrections to data in the ACL Anthology.
We generally distinguish five types of corrections, loosely following the [ACM Publications Policy](https://www.acm.org/publications/policies/):
The staff of the ACL Anthology can process requests for many types of corrections.
We generally distinguish five types, loosely following the [ACM Publications Policy](https://www.acm.org/publications/policies/):

* Corrections to **metadata** do not require changing the PDF.
Examples include correcting the spelling of a name or the title.
Expand Down
76 changes: 15 additions & 61 deletions hugo/content/info/credits.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,14 @@
Title: Credits
---

The ACL Anthology is run entirely by contributions from volunteers.
The ACL Anthology is largely a volunteer-run organization.
We are grateful to all our contributors whose work makes this collection of scholarly papers freely available to all.

### Active Volunteers

+ [Arya McCarthy](https://aryamccarthy.github.io/) (Johns Hopkins University) --- **MIT Press Ingestion Lead**
+ [Marcel Bollmann](https://marcel.bollmann.me/) (Jönköping University) --- **Site Development Lead**
+ [David Chiang](https://www3.nd.edu/~dchiang/) (University of Notre Dame) --- **Data Lead**
+ **Indexing Lead**: [A. Seza Doğruöz](https://lt3.ugent.be/people/as-dogruoz/) (Universiteit Gent)
+ **Site Development Lead**: [Marcel Bollmann](https://marcel.bollmann.me/) (Jönköping University)
+ **Data Lead**: [David Chiang](https://www3.nd.edu/~dchiang/) (University of Notre Dame)
+ [Arne Köhn](https://arne.chark.eu) (New Work SE)
+ [Daniel Gildea](https://www.cs.rochester.edu/u/gildea/) (University of Rochester)
+ [Kilian Gebhardt](https://wwwtcs.inf.tu-dresden.de/~kilian/) (TU Dresden)
Expand All @@ -33,11 +33,16 @@ We are grateful to all our contributors whose work makes this collection of scho

### Directors

+ [Matt Post](http://mjpost.github.io/) (2019&ndash;)
+ [Matt Post](http://waypost.net/) (2019&ndash;)
+ [Min-Yen Kan](http://www.comp.nus.edu.sg/~kanmy/) (2008&ndash;2018)
+ [Steven Bird](http://stevenbird.net/) (2001&ndash;2007)
+ Eduard Hovy, John Nerbonne, Mike Rosner, Nicoletta Calzolari and Doug Arnold (Past Associate Editors)

### Assistants

+ Xinru Yan (2020&ndash;)
+ [David Stap](https://davidstap.github.io) (2020&ndash;)

### Donors

We are indebted to the following individuals who generously supplied copies of out-of-print volumes for destructive scanning. Thank you!
Expand All @@ -46,65 +51,14 @@ We are indebted to the following individuals who generously supplied copies of o

+ **Donors of single volumes:** Elizabeth Andre, Sabine Bergler, Jason Eisner, Andy Kehler, Guy Lapalme, Alberto Lavelli, Winfried Lenders, Bente Maegaard, Mark Maybury, Kathleen McCoy, David McDonald, Ruslan Mitkov, Johanna Moore, John Nerbonne, Yael Netzer, Miles Osborne, Hannes Pirker, James Pustejovsky, Mike Rosner, Donia Scott, Evelyne Viegas, Bonnie Webber, Yorick Wilks.

+ **Donors of financial support:** We are also indebted to the following individuals who have provided financial support: Sumali Conlon, Barbara Di Eugenio, Margaret Fleck, Mary Harper, Woody Haynes, Lillian Lee, Edward Loper, Grace Ngai, Pierre Nugues, 1 anonymous donor.

### Sponsors

<div class="row">
<div class="col-lg-8 pr-1">
<div class="card my-2">
<div class="card-header bg-gold text-center">
<strong>Gold Sponsors</strong>
</div>
<div class="card-body d-flex flex-wrap"> <!-- "d-flex flex-wrap" lets the logos align nicely -->
{{< link_sponsor "Advanced Research and Development Activity" "arda-logo.gif" "http://ic-arda.org/" >}}
</div>
</div>
<div class="card my-2">
<div class="card-header bg-silver text-center">
<strong>Silver Sponsors</strong>
</div>
<div class="card-body d-flex flex-wrap">
{{< link_sponsor "Information Science Institute (USC)" "isi-logo.gif" "https://www.isi.edu/" >}}
{{< link_sponsor "MITRE Corporation" "mitre-logo.gif" "https://www.mitre.org/" >}}
{{< link_sponsor "ELSNET" "elsnet-logo.gif" "http://www.elsnet.org/" >}}
{{< link_sponsor "Netherlands Organization for Scientific Research (NWO)" "nwo-logo.gif" "https://www.nwo.nl/" >}}
{{< link_sponsor "Linguistic Data Consortium (UPenn)" "ldc-logo.gif" "https://www.ldc.upenn.edu/" >}}
{{< link_sponsor "Xerox Research Centre Europe" "xrce-logo.gif" "http://www.xrce.xerox.com/" >}}
</div>
</div>
</div>
<div class="col-lg-4 pl-1">
<div class="card my-2">
<div class="card-header bg-bronze text-center">
<strong>Bronze Sponsors</strong>
</div>
<div class="card-body d-flex flex-wrap">
{{< link_sponsor "Macquarie University" "mq-logo.png" "https://www.mq.edu.au/" >}}
{{< link_sponsor "School of Behavioral and Cognitive Neurosciences (Groningen)" "bcn-logo.gif" "https://www.rug.nl/research/behavioural-cognitive-neurosciences/" >}}
{{< link_sponsor "City University of Hong Kong" "cuhk-logo.gif" "https://cityu.edu.hk/" >}}
{{< link_sponsor "Center for Language and Speech Processing (JHU)" "jhu-logo.gif" "https://www.clsp.jhu.edu/" >}}
{{< link_sponsor "Information Technology Research Institute (Brighton)" "itri-logo.jpg" "https://www.itri.bton.ac.uk/" >}}
{{< link_sponsor "Columbia University" "columbia-logo.jpg" "https://www.cs.columbia.edu/" >}}
</div>
</div>
</div>
</div>

+ **Gold level:** Advanced Research and Development Activity
+ **Silver level:** Information Sciences Institute (USC), Linguistic Data Consortium (UPenn), MITRE Corporation, Netherlands Organization for Scientific Research, Xerox Research Centre Europe, ELSNET
+ **Bronze level:** Center for Language and Speech Processing (JHU), City University of Hong Kong, Columbia University, Information Technology Research Institute (Brighton), Macquarie University, School of Behavioral and Cognitive Neurosciences (Groningen)
+ **Donors of financial support:** We are also indebted to the following individuals who have provided financial support: Sumali Conlon, Barbara Di Eugenio, Margaret Fleck, Mary Harper, Woody Haynes, Lillian Lee, Edward Loper, Grace Ngai, Pierre Nugues, and 1 anonymous donor.

### Further Thanks

Other organizations that have supported the Anthology (e.g., with copyright transfer agreements):

<p class="text-center">
{{< link_sponsor "U. Chicago Press" "ucp-logo.jpg" "https://www.press.uchicago.edu/" >}}
</p>
Our thanks to:

Thanks to the European Language Resources Association (ELRA) for allowing us to link to the International Conference on Language Resources and Evaluation proceedings series (LREC).
* The University of Chicago Press, for early assistance with copyright transfer agreements.

Thanks to the Machine Translation Archive for allowing us to link to their scanned copies of the *Mechanical Translation and Computational Linguistics* journal, the precursor to the current *Computational Linguistics* journal.
* The European Language Resources Association (ELRA), for allowing us to host the International Conference on Language Resources and Evaluation proceedings series (LREC).

Thanks to Robert Amsler for his generous help and support of compiling the listing of the Finite String newsletter, and to David Chiang for undertaking the labor of splitting it up into readable articles.
* Robert Amsler for his generous help and support of compiling the listing of the Finite String newsletter, and to David Chiang for undertaking the labor of splitting it up into readable articles.
Loading

0 comments on commit b665348

Please sign in to comment.