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

feat: migrate pages from converia #79

Merged
merged 12 commits into from
Nov 8, 2024
Merged

Conversation

maehr
Copy link
Contributor

@maehr maehr commented Nov 6, 2024

Pull request

Proposed changes

Types of changes

  • New feature (non-breaking change which adds functionality).
  • Enhancement (non-breaking change which enhances functionality)
  • Bug Fix (non-breaking change which fixes an issue).
  • Breaking change (fix or feature that would cause existing functionality to change).

Checklist

  • I have read the README document.
  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.
  • I have mentioned all co-authors in the PR description as Co-authored-by: Name <[email protected]>.

Summary by CodeRabbit

Release Notes

  • New Features

    • Comprehensive updates to the README for improved installation and usage instructions.
    • Introduction of new documents for the conference, including "Terms and Conditions," "Call for Contributions," and detailed program schedules.
    • Enhanced navigation structure for a streamlined user experience.
    • New structured document for the "Book of Abstracts" detailing conference presentations.
  • Documentation

    • Significant revisions to the about.qmd to include essential information about the organizing committee, sponsors, and code of conduct.
    • New sections in various documents detailing submission guidelines, evaluation criteria, and logistical information for attendees.
  • Style

    • Updates to the website title and navigation items for clarity and conciseness.
    • Introduction of a new CSS class for button styling.

Copy link
Contributor

coderabbitai bot commented Nov 6, 2024

Caution

Review failed

The pull request is closed.

Walkthrough

The pull request introduces extensive modifications to various documentation files for the DigiHistCH24 conference. Key changes include a restructured README.md focusing on installation and usage instructions, updates to the _quarto.yml for navigation and sidebar organization, and the addition of several new documents detailing the conference program, submission guidelines, and ethical standards. The overall aim is to enhance clarity and accessibility for users and participants.

Changes

File Path Change Summary
README.md Reorganized to emphasize installation and usage instructions; removed repository structure details.
_quarto.yml Updated website title, navigation items, and sidebar contents; added local file links and modified sidebar structure.
about.qmd Added title, description, author, license metadata; introduced sections for organizing committee, sponsors, and code of conduct.
about/code-of-conduct.qmd Included contents of CODE_OF_CONDUCT.md for integration into the QMD document.
about/terms-and-conditions.qmd New document outlining terms for conference attendees, including registration, liability, and code of conduct.
book-of-abstracts.qmd New structured document for conference abstracts; includes metadata and sections for papers and posters.
call-for-contributions.qmd New document detailing the call for contributions, submission guidelines, and conference logistics.
call-for-contributions/key-dates.qmd New document listing important deadlines for the call for contributions.
call-for-contributions/review-process.qmd New document outlining evaluation criteria for submissions.
call-for-contributions/submission-guidelines.qmd New structured guidelines for submitting proposals.
conference-program.qmd New document detailing the conference program and schedule.
conference-program/info-event-digital-history-network-switzerland.qmd New document announcing a community meetup during the conference.
conference-program/info-event-ssh-ord.qmd New document about the Open Research Data Task Force event at the conference.
conference-program/practical-information.qmd New guide for attendees with venue directions and transportation details.
conference-program/schedule.qmd New file detailing the conference schedule with session information.
index.qmd Updated title, description, and organizational details; removed previous listing structure for papers and posters.

Possibly related PRs

  • feat: initial release #3: Changes in _quarto.yml related to navigation and project details align with the structural changes made in this PR.
  • Various minor fixes #10: Modifications in _quarto.yml for document presentation relate to the overall usability improvements in this PR.
  • ci: fix ci #11: Updates to CI workflow may indirectly support the main PR's focus on improving project structure and usability.
  • feat: migrate pages from converia #79: The significant restructuring of the README.md and _quarto.yml files mirrors the changes made in the main PR, focusing on installation instructions and navigation improvements.

Suggested labels

submission

Suggested reviewers

  • mtwente

🐰 In the garden of code, we hop with glee,
A README transformed, as clear as can be.
With guidelines and dates, our conference shines,
Digital history blooms, in well-structured lines.
So gather your abstracts, let knowledge take flight,
At DigiHistCH24, we’ll share our insights! 🌼


Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@maehr maehr requested a review from mtwente November 6, 2024 22:00
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 6

🧹 Outside diff range and nitpick comments (14)
_quarto.yml (1)

Line range hint 1-60: Consider adding URL redirects for migrated content.

Since this PR migrates content from Converia to local pages, consider implementing URL redirects to maintain any existing external links to the content. This can be achieved using HTML meta redirects or JavaScript-based solutions.

Would you like assistance in implementing a redirect solution?

call-for-contributions/submission-guidelines.qmd (2)

1-3: Consider enhancing the front matter with additional metadata.

Adding metadata fields would improve SEO and documentation. Consider including:

  • description
  • date
  • author
  • keywords
 ---
 title: Submission Guidelines
+description: "Guidelines for submitting papers and posters to DigiHistCH24 conference"
+date: last-modified
+author: "DigiHistCH24 Team"
+keywords: [conference, submission, guidelines, DigiHistCH24]
 ---

24-24: Consider adding more context about the closed submission platform.

The current message "CLOSED" might be too abrupt. Consider providing more information about when it closed or future opportunities.

-  - **Submission**: Please use the conference submission platform (CLOSED).
+  - **Submission**: The conference submission platform is now closed (as of December 4, 2023). We look forward to your submissions for future events.
book-of-abstracts.qmd (2)

18-19: Remove unused categories configuration in poster listing.

The poster listing has categories: true but doesn't include categories in its fields, which may cause confusion.

  - id: poster
    type: table
-   categories: true
    contents:

37-38: Consider enhancing the listing presentation.

The current implementation uses basic listing containers. Consider adding styling options or layout configurations to improve readability and visual appeal.

:::{#paper}
+ ::: {.column-page}
:::

:::{#poster}
+ ::: {.column-page}
:::

Also applies to: 42-43

about.qmd (3)

2-6: Consider enhancing the metadata section.

While the metadata is well-structured, consider these improvements:

  1. Add keywords-meta for better SEO
  2. Consider splitting the long description into a shorter meta description and moving the detailed content to the main body
  3. Add date-meta to track the last update
 title: About
-description-meta: "This repository contains the Book of Abstracts for the Digital History Switzerland 2024. Historical Research, Digital Literacy, and Algorithmic Criticism. The data in this repository is openly available to everyone and is intended to support reproducible research."
+description-meta: "Book of Abstracts for Digital History Switzerland 2024: Historical Research, Digital Literacy, and Algorithmic Criticism"
 author-meta: "Digital History Switzerland 2024"
 license: "AGPL-3.0"
+keywords-meta: "digital history, switzerland, conference, abstracts"
+date-meta: "2024"

10-17: Improve formatting consistency in the committee list.

The current format uses inconsistent line endings. Consider using a more structured format like a table for better readability and maintenance.

-Jérôme Baudry (Ecole polytechnique fédérale de Lausanne)  
-Lucas Burkart (Universität Basel)  
-Béatrice Joyeux-Prunel (Université de Genève)  
-Eliane Kurmann (infoclio.ch)  
-Moritz Mähr (Universität Basel, Stadt.Geschichte.Basel)  
-Enrico Natale (infoclio.ch, Verein Geschichte und Informatik)  
-Christiane Sibille (Verein Geschichte und Informatik, ETH Library)  
-Moritz Twente (Universität Basel, Stadt.Geschichte.Basel)
+| Name | Affiliation |
+|------|-------------|
+| Jérôme Baudry | Ecole polytechnique fédérale de Lausanne |
+| Lucas Burkart | Universität Basel |
+| Béatrice Joyeux-Prunel | Université de Genève |
+| Eliane Kurmann | infoclio.ch |
+| Moritz Mähr | Universität Basel, Stadt.Geschichte.Basel |
+| Enrico Natale | infoclio.ch, Verein Geschichte und Informatik |
+| Christiane Sibille | Verein Geschichte und Informatik, ETH Library |
+| Moritz Twente | Universität Basel, Stadt.Geschichte.Basel |

23-23: Improve image accessibility.

The alt text for the sponsoring logos image is too verbose and includes implementation details. Consider a more concise and descriptive alt text.

-[![Sponsoring: Swiss National Foundation, FAG Basel, Max-Geldner-Stiftung, Universität Basel (Departement Geschichte), Verein Informatik und Geschichte](images/sponsoring_logos.png)](https://conferences.unibas.ch/frontend/index.php?folder_id=236&page_id=#)
+[![Logos of DigiHistCH24 sponsors](images/sponsoring_logos.png)](https://conferences.unibas.ch/frontend/index.php?folder_id=236&page_id=#)
README.md (2)

13-20: Enhance installation instructions with version requirements and troubleshooting.

Consider adding:

  • Minimum version requirements for Quarto and Node.js
  • Links to platform-specific installation guides
  • Common troubleshooting steps or known issues
 ## Installation
 
-Install [Quarto](https://quarto.org/) and [Node.js](https://nodejs.org/) and run the following commands in the root directory of the repository:
+### Prerequisites
+
+- [Quarto](https://quarto.org/) (v1.0 or higher)
+- [Node.js](https://nodejs.org/) (v16 or higher)
+
+### Steps
+
+1. Clone the repository
+2. Run the following commands in the root directory:
 
 ```bash
 npm install
 npm run prepare

+### Troubleshooting
+
+If you encounter any issues during installation, please check our FAQ or open an issue.


---

Line range hint `1-12`: **Add context about Converia migration in introduction.**

Since this project involves migrating content from Converia, consider adding a brief note about this migration in the introduction section to provide context for users and contributors.

```diff
 # Digital History Switzerland 2024 Book of Abstracts
 
-This repository contains the Book of Abstracts for the Digital History Switzerland 2024. Historical Research, Digital Literacy and Algorithmic Criticism. The data in this repository is openly available to everyone and is intended to support reproducible research.
+This repository contains the Book of Abstracts for the Digital History Switzerland 2024: Historical Research, Digital Literacy and Algorithmic Criticism. Originally hosted on Converia, this content has been migrated to provide an open and accessible platform for sharing conference materials. The data in this repository is openly available to everyone and is intended to support reproducible research.
🧰 Tools
🪛 LanguageTool

[style] ~47-~47: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...bsite. bash quarto render blog Run the wizard to write meaningful commit m...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)


[style] ~53-~53: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ... messages. bash npm run commit Run the wizard to create a CHANGELOG.md. `...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)

call-for-contributions.qmd (2)

1-3: Consider enhancing YAML frontmatter with additional metadata.

Adding metadata fields could improve SEO and documentation:

 ---
 title: Call for Contributions
+description: "Call for contributions for DigiHistCH24 conference on Historical Research, Digital Literacy and Algorithmic Criticism"
+date: "2024-09-12"
+lang: en
+toc: true
 ---

38-45: Standardize institution formatting and consider adding contact information.

The institution names use inconsistent formatting (e.g., "Universität" vs "University" and different separators).

-Jérôme Baudry (Ecole polytechnique fédérale de Lausanne)  
-Lucas Burkart (Universität Basel)  
-Béatrice Joyeux-Prunel (Université de Genève)  
-Eliane Kurmann (infoclio.ch)  
-Moritz Mähr (Universität Basel, Stadt.Geschichte.Basel)  
-Enrico Natale (infoclio.ch, Verein Geschichte und Informatik)  
-Christiane Sibille (Verein Geschichte und Informatik, ETH Library)  
-Moritz Twente (Universität Basel, Stadt.Geschichte.Basel)
+Jérôme Baudry (EPFL - École polytechnique fédérale de Lausanne)  
+Lucas Burkart (University of Basel)  
+Béatrice Joyeux-Prunel (University of Geneva)  
+Eliane Kurmann (infoclio.ch)  
+Moritz Mähr (University of Basel, Stadt.Geschichte.Basel)  
+Enrico Natale (infoclio.ch, Swiss Society for History and Computing)  
+Christiane Sibille (Swiss Society for History and Computing, ETH Library)  
+Moritz Twente (University of Basel, Stadt.Geschichte.Basel)

Consider adding contact information or ORCID identifiers for committee members where appropriate.

index.qmd (2)

12-13: Update the conference description to past tense.

To accurately reflect that the conference has concluded, consider adjusting the description to past tense and highlighting the outcomes or impact of the event.

Here is a suggested update:

-This conference provides a platform for scholars, researchers and professionals of all ages and levels of experience to discuss these challenges, exchange experiences, share best practices, and discuss forward-looking approaches to historical research in the digital age. It aims to promote digital literacy, raise awareness of the use of algorithms and AI systems, develop strategies for dealing with digital sources, encourage shared formats and methodologies, and facilitate the exchange of knowledge and best practices for collaborative historical research. The conference will also showcase projects and research in the field of digital history.
+The conference provided a platform for scholars, researchers, and professionals of all ages and levels of experience to discuss challenges, exchange experiences, share best practices, and explore forward-looking approaches to historical research in the digital age. It aimed to promote digital literacy, raise awareness of the use of algorithms and AI systems, develop strategies for dealing with digital sources, encourage shared formats and methodologies, and facilitate the exchange of knowledge and best practices for collaborative historical research. The conference also showcased projects and research in the field of digital history.

16-18: Ensure external links open in a new tab consistently.

While you have used target="_blank" and rel="noopener" in your anchor tags, consider adding rel="noreferrer" as well to enhance security and privacy when opening external links.

Here is a suggested update:

-See <a href="https://www.infoclio.ch/en/digitalhistorynetwork" target="_blank" rel="noopener">infoclio.ch</a> for more information.
+See <a href="https://www.infoclio.ch/en/digitalhistorynetwork" target="_blank" rel="noopener noreferrer">infoclio.ch</a> for more information.

And for the image link:

-<a href="https://www.infoclio.ch/en/digitalhistorynetwork" target="_blank" rel="noopener"><img src="/images/logo_digital_history_network_ch.svg" width="600" /></a>
+<a href="https://www.infoclio.ch/en/digitalhistorynetwork" target="_blank" rel="noopener noreferrer"><img src="/images/logo_digital_history_network_ch.svg" width="600" /></a>
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between ecae45c and 5495643.

⛔ Files ignored due to path filters (4)
  • files/digihistch24_brochure.pdf is excluded by !**/*.pdf
  • images/brochure_cover.jpg is excluded by !**/*.jpg
  • images/converia_map.png is excluded by !**/*.png
  • images/logo_digital_history_network_ch.svg is excluded by !**/*.svg
📒 Files selected for processing (16)
  • README.md (1 hunks)
  • _quarto.yml (2 hunks)
  • about.qmd (1 hunks)
  • about/code-of-conduct.qmd (1 hunks)
  • about/terms-and-conditions.qmd (1 hunks)
  • book-of-abstracts.qmd (1 hunks)
  • call-for-contributions.qmd (1 hunks)
  • call-for-contributions/key-dates.qmd (1 hunks)
  • call-for-contributions/review-process.qmd (1 hunks)
  • call-for-contributions/submission-guidelines.qmd (1 hunks)
  • conference-program.qmd (1 hunks)
  • conference-program/info-event-digital-history-network-switzerland.qmd (1 hunks)
  • conference-program/info-event-ssh-ord.qmd (1 hunks)
  • conference-program/practical-information.qmd (1 hunks)
  • conference-program/schedule.qmd (1 hunks)
  • index.qmd (1 hunks)
✅ Files skipped from review due to trivial changes (9)
  • about/code-of-conduct.qmd
  • about/terms-and-conditions.qmd
  • call-for-contributions/key-dates.qmd
  • call-for-contributions/review-process.qmd
  • conference-program.qmd
  • conference-program/info-event-digital-history-network-switzerland.qmd
  • conference-program/info-event-ssh-ord.qmd
  • conference-program/practical-information.qmd
  • conference-program/schedule.qmd
🧰 Additional context used
🪛 LanguageTool
README.md

[style] ~47-~47: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ...bsite. bash quarto render blog Run the wizard to write meaningful commit m...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)


[style] ~53-~53: Three successive sentences begin with the same word. Consider rewording the sentence or use a thesaurus to find a synonym.
Context: ... messages. bash npm run commit Run the wizard to create a CHANGELOG.md. `...

(ENGLISH_WORD_REPEAT_BEGINNING_RULE)

🔇 Additional comments (14)
_quarto.yml (3)

28-35: Verify the existence of referenced .qmd files.

The navigation structure looks good, but let's ensure all referenced .qmd files exist in the repository.

#!/bin/bash
# Description: Check if all referenced .qmd files exist

# List of files to check
files=("index.qmd" "book-of-abstracts.qmd" "conference-program.qmd" "call-for-contributions.qmd" "about.qmd")

# Check each file
for file in "${files[@]}"; do
    if [ -f "$file" ]; then
        echo "$file exists"
    else
        echo "$file missing"
    fi
done

41-60: Verify directory structure and document content organization.

The sidebar configuration uses auto-generation from several directories. This needs verification and documentation:

  1. Verify that all referenced directories exist and contain appropriate content
  2. Document the expected content structure for maintainers

Consider adding a comment block in the YAML file documenting the expected directory structure and naming conventions for content files.

  sidebar:
    style: 'docked'
    collapse-level: 1
+   # Content Organization:
+   # - submissions/*/index.qmd: Individual submission files
+   # - conference-program/*.qmd: Program schedule and details
+   # - call-for-contributions/*.qmd: Submission guidelines
+   # - about/*.qmd: General information pages
    contents:
✅ Verification successful

Directory structure and content patterns verified successfully

All referenced directories exist and contain appropriate content:

  • submissions/*/index.qmd pattern matches 39 submission files including keynotes and posters
  • conference-program/*.qmd contains 4 program-related files
  • call-for-contributions/*.qmd contains 3 guideline files
  • about/*.qmd contains 2 information pages

The auto-generation patterns in the sidebar configuration are working as expected with the current content structure.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Verify directory structure and content patterns

# Check directories
directories=("submissions" "conference-program" "call-for-contributions" "about")

echo "Checking directory structure:"
for dir in "${directories[@]}"; do
    if [ -d "$dir" ]; then
        echo "$dir/ exists"
        echo "  Contents:"
        find "$dir" -name "*.qmd" -type f
    else
        echo "$dir/ missing"
    fi
done

Length of output: 2374


5-5: Verify the site-url configuration.

The title change looks good, making it more concise. However, please verify that the site-url configuration matches the actual deployment URL for the migrated content.

✅ Verification successful

Let me try to get the site-url configuration from the _quarto.yml file:


Site URL configuration is correctly set up

The site-url is properly configured to https://digihistch24.github.io/book-of-abstracts/ which matches the expected GitHub Pages URL pattern for this repository. The title change and URL configuration are both appropriate for the migrated content.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Check if the repository is configured for GitHub Pages
# and verify the deployment URL matches the configuration

# Check GitHub Pages settings
gh api repos/digihistch24/book-of-abstracts | jq '.homepage, .has_pages'

Length of output: 727


Script:

#!/bin/bash
# Check the site-url configuration in _quarto.yml
cat _quarto.yml | grep -A 1 "site-url"

Length of output: 163

call-for-contributions/submission-guidelines.qmd (3)

14-19: LGTM! Clear and well-formatted poster proposal guidelines.

The section provides clear instructions with consistent formatting.


27-27: LGTM! Contact information is properly formatted.

The email address is correctly obfuscated to prevent spam while maintaining usability.


25-25: Verify the review process link.

The link to /review-process needs verification to ensure it correctly points to the evaluation criteria document.

✅ Verification successful

Link to review process is valid and correctly points to evaluation criteria

The link /review-process correctly points to call-for-contributions/review-process.qmd, which contains detailed evaluation criteria including scoring dimensions (Question/Interest/Claim 40%, Data/Sources/Source Code 30%, Method 30%) and rating categories. The document exists and serves its intended purpose.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Check if the review process document exists
fd "review-process.qmd" || fd "review-process.md"

# Search for any references to evaluation criteria
rg -l "evaluation criteria" 

Length of output: 144


Script:

#!/bin/bash
# Let's verify the content of review-process.qmd to ensure it contains evaluation criteria
cat call-for-contributions/review-process.qmd

Length of output: 2472

book-of-abstracts.qmd (3)

29-33: LGTM! Clear and well-structured content.

The conference description effectively communicates the purpose and scope of the book of abstracts.


45-53: Address the commented sponsor section.

The commented sponsor section appears to be part of the migration but is currently disabled. Consider:

  1. Verifying if this section should be included
  2. Checking if the referenced image files exist
  3. Using Quarto's native commenting syntax instead of HTML comments
#!/bin/bash
# Description: Check if the referenced image files exist

echo "Checking for sponsor and patronage logo images..."
fd --type f "sponsoring_logos.png|patronage_logos.png" "images"

7-8: Verify the submission paths exist in the repository.

The listings are configured to look for submissions in specific paths. Let's verify these paths exist and contain the expected content.

Also applies to: 20-20

✅ Verification successful

The submission paths are correctly configured and exist in the repository

The verification confirms that:

  • Multiple submission directories exist under submissions/ with valid index.qmd files
  • Both regular submissions (32 entries) and poster submissions (6 entries) are present in the expected directory structure
  • The path pattern submissions/*/index.qmd in the configuration will correctly match all these files
🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Check if the submission paths exist and contain content

# Test 1: Check for paper submissions
echo "Checking paper submissions directory structure..."
fd --type d "submissions"

# Test 2: Check for poster submissions
echo "Checking poster submissions directory structure..."
fd --type d "submissions/poster"

# Test 3: Check for index.qmd files in these directories
echo "Checking for index.qmd files in submission directories..."
fd --type f "index.qmd" "submissions"

Length of output: 2063

about.qmd (2)

40-42: LGTM!

The host section is clear and well-structured.


44-48: LGTM!

The Code of Conduct section is comprehensive and well-written, with appropriate links to official resources and support channels.

call-for-contributions.qmd (2)

1-45: Verify completeness of content migration from Converia.

Let's ensure all content has been properly migrated from the source platform.

#!/bin/bash
# Check for any remaining references to the Converia platform
rg -i "converia" .

# Look for potential missing sections by comparing with common conference page elements
echo "Checking for common conference page sections..."
SECTIONS=("registration" "deadlines" "important dates" "schedule" "program" "fees" "accommodation" "travel")
for section in "${SECTIONS[@]}"; do
    echo "Searching for '$section'..."
    rg -i "$section" call-for-contributions.qmd
done

34-34: Consider including submission guidelines in the repository.

Relying on external links for crucial information like submission guidelines could be risky if the URL changes or becomes inaccessible.

Consider:

  1. Including the guidelines directly in this repository
  2. Creating a separate submission-guidelines.qmd file
  3. Maintaining both the external link and a local copy

Let me verify if the guidelines are already in the repository:

index.qmd (1)

22-29: Verify the accuracy of the organizing committee affiliations.

Please ensure that all affiliations are up-to-date and correctly formatted, as organizational changes may have occurred since the initial drafting.

If needed, you can confirm the current affiliations by checking the official websites or recent publications of the committee members.

call-for-contributions/submission-guidelines.qmd Outdated Show resolved Hide resolved
about.qmd Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
call-for-contributions.qmd Outdated Show resolved Hide resolved
index.qmd Outdated Show resolved Hide resolved
index.qmd Show resolved Hide resolved
@mtwente
Copy link
Contributor

mtwente commented Nov 6, 2024

I had a quick look around:

  • the sponsoring logo file on about.html is still fetched from Converia (but host logo file is not). Some hyperlinks point to converia, too.
  • lists are sometimes not formatted as such (e.g. OC members on home, but on about it works)
  • internal hyperlinks do not work (missing .html in the end of the URL), e.g. all links on conference-program
  • schedule only shows time+chair: we could add the presentations for each session, linking to the abstracts
  • make sure all image alt-texts have been migrated properly
  • sub-items of sidebar menu item Conference Program are ordered counter-intuitively (schedule should come first)
  • is the separate keynote page missing on purpose?
  • imprint/privacy policy from converia have not been migrated. Do you want an exact copy of converia or does it make more sense to create a new imprint?
  • on a similar note: keep present tense/switch to past tense? Keep preliminary/wrong room allocation or update to de-facto rooms?
  • explicit contact info is missing (basically the right column on converia)
  • all abstracts will link to zenodo. We could additionally include a sentence about the Zenodo community and/or the slides that were (in some cases) published along side.
    • maybe slide linking on the abstracts could be improved, ATM it's almost invisible using quarto features

@maehr
Copy link
Contributor Author

maehr commented Nov 7, 2024

I had a quick look around:

  • the sponsoring logo file on about.html is still fetched from Converia (but host logo file is not). Some hyperlinks point to converia, too.

  • lists are sometimes not formatted as such (e.g. OC members on home, but on about it works)

  • internal hyperlinks do not work (missing .html in the end of the URL), e.g. all links on conference-program

  • schedule only shows time+chair: we could add the presentations for each session, linking to the abstracts

  • make sure all image alt-texts have been migrated properly

  • sub-items of sidebar menu item Conference Program are ordered counter-intuitively (schedule should come first)

  • is the separate keynote page missing on purpose?

  • imprint/privacy policy from converia have not been migrated. Do you want an exact copy of converia or does it make more sense to create a new imprint?

  • on a similar note: keep present tense/switch to past tense? Keep preliminary/wrong room allocation or update to de-facto rooms?

  • explicit contact info is missing (basically the right column on converia)

  • all abstracts will link to zenodo. We could additionally include a sentence about the Zenodo community and/or the slides that were (in some cases) published along side.

    • maybe slide linking on the abstracts could be improved, ATM it's almost invisible using quarto features

Actionable Follow-ups:

  • Link Sessions to Schedule: Update the schedule to link each session to the appropriate detailed session page.
  • Image ALT Texts: Review all images to confirm that alt-texts are accurately migrated and relevant.
  • Keynote Page Addition: Add the keynote page as required.
  • Imprint Decision: Clarify whether to create a new imprint or replicate the Converia version as is.
  • Consistent Language Use: Keep all content in the present tense.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 6

🧹 Outside diff range and nitpick comments (6)
_quarto.yml (2)

22-22: Consider using standard HTML/CSS for title formatting.

The triple asterisks markdown emphasis (***DigiHistCH24***) might not render consistently across all browsers. Consider using HTML/CSS styling instead.

-    title: '***DigiHistCH24***'
+    title: '<strong><em>DigiHistCH24</em></strong>'

43-69: Consider consistent approach for content generation.

Some sections use auto for content generation while others use manual listings. Consider using auto consistently where possible to reduce maintenance overhead.

call-for-contributions.qmd (2)

1-3: Consider enhancing YAML metadata.

The YAML frontmatter could benefit from additional metadata fields to improve SEO and document management.

 ---
 title: Call for Contributions
+description: "Call for Contributions for Digital History Switzerland 2024 conference focusing on historical research, digital literacy, and algorithmic criticism"
+date: "2024-09-12"
+lang: "en"
 ---

5-11: Improve readability with visual hierarchy.

The introduction provides excellent context but could benefit from better visual structure to enhance readability.

Consider breaking down the second paragraph into bullet points:

-Within this general context, a lot of questions need urgently to be discussed. What are the basic elements of data literacy which every historian should know about? What is algorithmic criticism and how can it be practiced in our every-day research routines? How do we manage the data we produce during the research process?  Which criteria (if any) should we use to choose a software for a specific task? Where to find help when faced with a methodological or a computer problem – or a combination of both? How to set up interdisciplinary collaborations? How do we handle technologies that some of their inventors construct as ‹black boxes›? How can we deal with the rapidly increasing demand for very different resources (e.g. technical knowledge, computing power, money)? etc.  
+Within this general context, several key questions need to be discussed:
+
+- What are the basic elements of data literacy which every historian should know about?
+- What is algorithmic criticism and how can it be practiced in our every-day research routines?
+- How do we manage the data we produce during the research process?
+- Which criteria should we use to choose software for specific tasks?
+- Where to find help when faced with methodological or computer problems?
+- How to set up interdisciplinary collaborations?
+- How do we handle "black box" technologies?
+- How can we manage increasing resource demands (technical knowledge, computing power, funding)?
README.md (2)

13-20: Enhance installation instructions with version requirements and troubleshooting.

The installation section would benefit from additional details:

  • Specify minimum required versions for Quarto and Node.js
  • Add troubleshooting tips for common installation issues
  • Include verification steps to confirm successful installation
 ## Installation
 
-Install [Quarto](https://quarto.org/) and [Node.js](https://nodejs.org/) and run the following commands in the root directory of the repository:
+### Prerequisites
+
+- [Quarto](https://quarto.org/) (v1.3 or higher)
+- [Node.js](https://nodejs.org/) (v18 or higher)
+
+### Setup
 
 ```bash
 npm install
 npm run prepare

+### Verify Installation
+
+Run the following command to verify the setup:
+bash +quarto check +


---

`64-82`: **Add context for version control commands.**

The version control section would benefit from additional context about when to use these commands:
- Explain that `npm run commit` should be used instead of `git commit`
- Clarify when to run `npm run changelog` (e.g., before releases)

```diff
 ### 4. Version Control
 
 **Commit Messages Wizard**  
-This command launches an interactive prompt to help create standardized, meaningful commit messages.
+This command launches an interactive prompt to help create standardized, meaningful commit messages. Always use this instead of `git commit` to ensure consistent commit message formatting across the project.
 
 ```bash
 npm run commit

Expected output: A structured prompt for crafting a detailed commit message.

Generate Changelog
-This command automatically creates or updates a CHANGELOG.md file based on recent commits.
+This command automatically creates or updates a CHANGELOG.md file based on recent commits. Run this before creating a new release to document all changes since the last version.


</blockquote></details>

</blockquote></details>

<details>
<summary>📜 Review details</summary>

**Configuration used: CodeRabbit UI**
**Review profile: CHILL**

<details>
<summary>📥 Commits</summary>

Reviewing files that changed from the base of the PR and between 54956431fa52c6b14c1b62ee6fe484457cd032a6 and 4faa59178953db0d6ed83509e43978ac5724814c.

</details>

<details>
<summary>📒 Files selected for processing (9)</summary>

* `README.md` (1 hunks)
* `_quarto.yml` (2 hunks)
* `about.qmd` (1 hunks)
* `about/terms-and-conditions.qmd` (1 hunks)
* `call-for-contributions.qmd` (1 hunks)
* `call-for-contributions/submission-guidelines.qmd` (1 hunks)
* `conference-program.qmd` (1 hunks)
* `conference-program/schedule.qmd` (1 hunks)
* `index.qmd` (1 hunks)

</details>

<details>
<summary>🚧 Files skipped from review as they are similar to previous changes (4)</summary>

* about/terms-and-conditions.qmd
* call-for-contributions/submission-guidelines.qmd
* conference-program.qmd
* conference-program/schedule.qmd

</details>

<details>
<summary>🔇 Additional comments (13)</summary>

<details>
<summary>_quarto.yml (2)</summary>

Line range hint `5-21`: **LGTM! Basic website configuration is well-structured.**

The website configuration follows Quarto best practices with appropriate settings for SEO, navigation, and search functionality.

---

`28-35`: **Verify internal link functionality.**

Based on previous review comments, internal links might need `.html` extensions to function correctly.

<details>
<summary>✅ Verification successful</summary>

Let me generate additional verification scripts to check Quarto's configuration and link handling.




The absence of HTML files in `_site/` could be due to the sandbox environment not building the site. Let's check the configuration and existing link patterns to make a more informed decision.

---

**Internal links in navigation do not require .html extensions**

Based on the verification results:
1. The Quarto configuration (`_quarto.yml`) shows a proper website setup with correct navigation structure
2. Only one explicit HTML extension was found in an inline link within `index.qmd`, but not in the navigation configuration
3. Quarto's default behavior handles the link extensions automatically during site building

The current navigation setup without `.html` extensions is correct and follows Quarto's best practices. The absence of files in `_site/` is expected as the sandbox environment doesn't build the site.



</details>

<details>
<summary>🏁 Scripts executed</summary>

The following scripts were executed for the analysis:

Script:

```shell
#!/bin/bash
# Check if the referenced QMD files exist and verify their paths
echo "Checking referenced QMD files..."
for file in index.qmd book-of-abstracts.qmd conference-program.qmd call-for-contributions.qmd about.qmd; do
  if [ ! -f "$file" ]; then
    echo "Warning: $file not found"
  fi
done

# Check if HTML files are generated for these QMDs
echo "Checking for corresponding HTML files..."
for file in index.html book-of-abstracts.html conference-program.html call-for-contributions.html about.html; do
  if [ ! -f "_site/$file" ]; then
    echo "Warning: _site/$file not found - might cause broken links"
  fi
done

Length of output: 2398


Script:

#!/bin/bash
# Check Quarto configuration for output settings
echo "Checking Quarto configuration..."
cat _quarto.yml

# Check if there are any explicit HTML extensions in links across QMD files
echo -e "\nChecking for HTML extensions in links..."
rg -g "*.qmd" "href.*\.html"

# Check if there are any other Quarto projects or examples in the repo
echo -e "\nChecking for other Quarto examples..."
fd -g "_quarto.yml"

Length of output: 4396

index.qmd (2)

2-6: LGTM! Verify conference dates in description.

The front matter is well-structured. However, since this appears to be a post-conference document, verify if the dates should be updated to reflect that the event has already occurred.


8-12: Previous comment about updating tense remains valid.

The text still uses future tense and mentions registration, although the conference has concluded.

about.qmd (5)

2-5: LGTM! Well-structured metadata.

The metadata section is complete with appropriate title, description, author, and license information.


31-37: LGTM! Well-structured patronage section with proper accessibility.

The section includes well-formatted links with titles and appropriate alt text for the image.


39-47: LGTM! Comprehensive Code of Conduct section.

The section effectively communicates the commitment to safety and inclusivity, with appropriate links to official university resources and clear contact information.


49-71: LGTM! Complete contact and legal information.

The sections provide comprehensive contact details and legal information, addressing the PR objective about including explicit contact information.


19-29: Verify sponsoring logos image source.

According to the PR objectives, there was a concern about sponsoring logos being fetched from Converia. Please verify that the sponsoring_logos.png is now stored locally in the images/ directory and not being fetched from Converia.

Let's verify the image location:

#!/bin/bash
# Check if sponsoring_logos.png exists locally
fd "sponsoring_logos.png"

# Check for any remaining references to Converia
rg -i "converia" .
call-for-contributions.qmd (3)

32-34: LGTM!

The internal link to submission guidelines is correctly formatted with the .html extension.


36-45: LGTM!

The organizing committee list is properly formatted using markdown bullet points, maintaining consistency with best practices.


18-18: ⚠️ Potential issue

Fix registration information structure and link.

The current line combines multiple pieces of information and contains a problematic link reference.

-Financial support is available for individuals whose institutions are unable to cover travel and accommodation costs. Please contact [[email protected]](mailto:[email protected]) for further details. Registration for Digital History Switzerland 2024 will be possible on this platform (CLOSED) starting June 03, 2024.
+Financial support is available for individuals whose institutions are unable to cover travel and accommodation costs. Please contact [[email protected]](mailto:[email protected]) for further details.
+
+Registration for Digital History Switzerland 2024 will be possible [through our registration portal](https://conferences.unibas.ch/frontend/index.php?folder_id=235) starting June 03, 2024.
README.md (1)

11-11: Update Zenodo DOI badge.

The commented-out Zenodo DOI badge should be updated once the abstracts are published on Zenodo, as mentioned in the PR comments about linking all abstracts to Zenodo.

_quarto.yml Outdated Show resolved Hide resolved
_quarto.yml Outdated Show resolved Hide resolved
index.qmd Outdated Show resolved Hide resolved
index.qmd Outdated Show resolved Hide resolved
about.qmd Show resolved Hide resolved
call-for-contributions.qmd Show resolved Hide resolved
maehr and others added 3 commits November 7, 2024 09:38
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
@maehr maehr requested review from mtwente and removed request for mtwente November 7, 2024 10:07
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between 4faa591 and ecd6661.

⛔ Files ignored due to path filters (2)
  • images/ORD_Logo.png is excluded by !**/*.png
  • images/conference_location_map.png is excluded by !**/*.png
📒 Files selected for processing (5)
  • _quarto.yml (2 hunks)
  • conference-program/info-event-ssh-ord.qmd (1 hunks)
  • conference-program/practical-information.qmd (1 hunks)
  • conference-program/schedule.qmd (1 hunks)
  • index.qmd (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (4)
  • _quarto.yml
  • conference-program/info-event-ssh-ord.qmd
  • conference-program/practical-information.qmd
  • conference-program/schedule.qmd
🔇 Additional comments (3)
index.qmd (3)

2-5: LGTM! Well-structured metadata.

The metadata section is comprehensive and properly formatted, with a clear title, description, and author information.


14-18: LGTM! Well-structured network section.

The section provides clear information about the network with proper accessibility features and secure external linking.


20-29: LGTM! Well-formatted committee list.

The organizing committee is properly formatted as a list with clear member affiliations.

index.qmd Show resolved Hide resolved
@maehr maehr requested a review from mtwente November 7, 2024 15:57
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between ecd6661 and b4f967b.

📒 Files selected for processing (5)
  • conference-program.qmd (1 hunks)
  • conference-program/info-event-ssh-ord.qmd (1 hunks)
  • conference-program/practical-information.qmd (1 hunks)
  • conference-program/schedule.qmd (1 hunks)
  • styles.css (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (4)
  • conference-program.qmd
  • conference-program/info-event-ssh-ord.qmd
  • conference-program/practical-information.qmd
  • conference-program/schedule.qmd
🔇 Additional comments (2)
styles.css (2)

107-112: LGTM! Consistent hover styling.

The hover state styling matches the existing navbar link hover style, maintaining visual consistency across the UI.


99-106: Verify color contrast for accessibility.

Please ensure that the color contrast ratio between the text (#181818) and background (#a5d7d2) meets WCAG accessibility standards for better readability.

styles.css Outdated Show resolved Hide resolved
@maehr maehr merged commit 3be8f7e into digihistch24:main Nov 8, 2024
3 checks passed
@maehr maehr deleted the migrate_converia branch November 8, 2024 09:29
@coderabbitai coderabbitai bot mentioned this pull request Nov 8, 2024
8 tasks
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.

2 participants