summaryrefslogtreecommitdiff
path: root/site/community
diff options
context:
space:
mode:
authorFabian Mastenbroek <mail.fabianm@gmail.com>2022-08-04 16:40:44 +0200
committerFabian Mastenbroek <mail.fabianm@gmail.com>2022-09-13 16:15:59 +0200
commitfdc3200ef4718eb98bd8a713f956222a9bf85ac9 (patch)
tree4fa8e5998bd4ee59397b26222846c554b73abe4e /site/community
parent8a94318aad4b4fa188ac49e887d564867a00111e (diff)
docs: Add initial version of Docusaurus based docs
This change updates the repository with a new Docusaurus-based documentation website. This allows us to create our documentation using Markdown, MDX and React. This will serve as the main entry point for users visiting https://opendc.org. The actual OpenDC application will be moved to https://app.opendc.org.
Diffstat (limited to 'site/community')
-rw-r--r--site/community/0-support.mdx39
-rw-r--r--site/community/1-team.mdx13
-rw-r--r--site/community/2-contributing.md36
-rw-r--r--site/community/3-research.md64
4 files changed, 152 insertions, 0 deletions
diff --git a/site/community/0-support.mdx b/site/community/0-support.mdx
new file mode 100644
index 00000000..a0a158bc
--- /dev/null
+++ b/site/community/0-support.mdx
@@ -0,0 +1,39 @@
+# Support
+
+Need help? You can find out ways to talk to maintainers and community members below.
+
+<div className="container">
+ <div className="row">
+ <div className="col col--4">
+ <h2>Browse the docs</h2>
+ <p>Find what you're looking for in our documentation and guides.</p>
+ <ul>
+ <li>Learn how to <a href="/docs/category/getting-started">get started</a> with OpenDC.</li>
+ <li>Follow the provided <a href="/docs/category/tutorials">tutorials</a>.</li>
+ <li>Look at the <a href="/docs/category/advanced-guides">advanced guides</a>.</li>
+ </ul>
+ </div>
+ <div className="col col--4">
+ <h2>Join the community</h2>
+ <p>Ask questions and find answers from other OpenDC users.</p>
+ <ul>
+ <li>Report bugs and feature requests via <a href="https://github.com/atlarge-research/opendc/issues">GitHub Issues</a></li>
+ <li>Open a discussion on our <a href="https://github.com/atlarge-research/opendc/discussions">GitHub Discussions</a> page</li>
+ </ul>
+ </div>
+ <div className="col col--4">
+ <h2>Stay up to date</h2>
+ <p>Find out what's new in OpenDC.</p>
+ <ul>
+ <li>Track the project on <a href="https://github.com/atlarge-research/opendc">GitHub</a>.</li>
+ <li>Follow AtLarge Research on <a href="https://twitter.com/LargeResearch">Twitter</a>.</li>
+ </ul>
+ </div>
+ </div>
+</div>
+
+## Need to contact the maintainers?
+
+Opening an issue or discussion on GitHub is always preferred so other community members can also contribute to and
+benefit from the answers. However, if you need (private) contact with the maintainers, you may contact us
+at 📧[opendc@atlarge-research.com](mailto:opendc@atlarge-research.com).
diff --git a/site/community/1-team.mdx b/site/community/1-team.mdx
new file mode 100644
index 00000000..719bf280
--- /dev/null
+++ b/site/community/1-team.mdx
@@ -0,0 +1,13 @@
+import TeamMembers from '@site/src/components/TeamMembers';
+
+# Team
+
+The OpenDC project is currently developed and maintained by the [AtLarge Research Group](https://www.atlarge-research.com/)
+from Amsterdam, the Netherlands. The team that works (or has worked) on OpenDC consists of:
+
+<TeamMembers />
+
+## Want to join our team?
+
+If you are interested in joining the OpenDC team, sent us a message at [opendc@atlarge-research.com](mailto:opendc@atlarge-research.com)
+or visit the [AtLarge Research website](https://www.atlarge-research.com/new_students.html) for more information.
diff --git a/site/community/2-contributing.md b/site/community/2-contributing.md
new file mode 100644
index 00000000..36cd5cb5
--- /dev/null
+++ b/site/community/2-contributing.md
@@ -0,0 +1,36 @@
+---
+title: Contributing
+hide_title: true
+sidebar_label: Contributing
+---
+
+# Contributing to OpenDC
+
+First of all, thank you for wanting to contribute to OpenDC!
+You can contribute in various meaningful ways:
+
+* Report a bug through [GitHub issues](https://github.com/fabianishere/atlarge-research/issues).
+* Propose new functionality for using this project.
+* Contribute improvements to the code and documentation.
+* Provide feedback about how we can improve the project.
+* Help answer questions on our [Discussions](https://github.com/atlarge-research/discussions) page.
+
+## Want to report a bug or suggest a feature?
+
+Please file an issue! First, have a look if someone has already filed an issue addressing your concern. If there already
+is such an issue, feel free to comment on the issue to show your support for it, or to add additional information that
+might be helpful. You can also just react with a thumbs-up 👍 to the issue, to indicate that you'd be interested in its
+resolution. This can help us prioritize what we spend our development time on.
+
+If you can't find an issue that fits your problem or feature request, open a new one. Describe actual and expected
+behavior, and be as detailed as you can. We'll get back to you asap!
+
+## Want to contribute code?
+
+That's great! If you want to contribute to this
+repository, [fork it](https://github.com/atlarge-research/opendc/new/master) and submit a pull request here when you're
+ready! Be sure to describe *what* you changed and *why* you changed it, to help us understand what your contribution is
+about.
+
+A quick note on commit messages: Please follow common Git standards when writing commit messages,
+see [this post](https://cbea.ms/git-commit/) for details.
diff --git a/site/community/3-research.md b/site/community/3-research.md
new file mode 100644
index 00000000..dc3a9858
--- /dev/null
+++ b/site/community/3-research.md
@@ -0,0 +1,64 @@
+---
+title: Research
+hide_title: true
+sidebar_label: Research
+---
+
+# Research with OpenDC
+
+On this page we list publications related to OpenDC or publications that have used OpenDC in their work.
+
+## Interested in working with us?
+
+If you are a new student and are interested in doing a project (e.g., bachelor thesis, master thesis) on OpenDC with us,
+please visit [AtLarge Research website](https://www.atlarge-research.com/new_students.html) for more information.
+For a sneak peek of the kind of work we do, have a look at the material listed below.
+
+
+## Publications about OpenDC
+
+1. [OpenDC 2.0: Convenient Modeling and Simulation of Emerging Technologies in Cloud Datacenters](https://atlarge-research.com/pdfs/ccgrid21-opendc-paper.pdf)
+ **CCGrid 2021**
+ Fabian Mastenbroek, Georgios Andreadis, Soufiane Jounaid, Wenchen Lai, Jacob Burley, Jaro Bosch, Erwin van Eyk,
+ Laurens Versluis, Vincent van Beek, Alexandru Iosup
+2. [The OpenDC vision: Towards collaborative datacenter simulation and exploration for everybody](https://atlarge-research.com/pdfs/opendc-vision17ispdc_cr.pdf)
+ **ISPDC 2017 (invited paper)**
+ Alexandru Iosup, Georgios Andreadis, Vincent van Beek, Matthijs Bijman, Erwin van Eyk, Mihai Neacsu, Leon Overweel,
+ Sacheendra Talluri, Laurens Versluis, Maaike Visser.
+
+## Publications using OpenDC
+
+1. [Capelin: Data-Driven Compute Capacity Procurement for Cloud Datacenters Using Portfolios of Scenarios](https://www.computer.org/csdl/journal/td/2022/01/09444213/1tYo2a8BeWA)
+ **IEEE Transactions on Parallel and Distributed Systems (TPDS), Jan. 2022**
+ Georgios Andreadis, Fabian Mastenbroek, Vincent van Beek, Alexandru Iosup
+2. [A Reference Architecture for Datacenter Scheduling](https://arxiv.org/pdf/1808.04224)
+ **International Conference for High Performance Computing, Networking, Storage and Analysis 2018 (SC18)**
+ Georgios Andreadis, Laurens Versluis, Fabian Mastenbroek, Alexandru Iosup
+
+## Students using OpenDC
+There have been also multiple students projects that have used OpenDC:
+
+1. [Radice: Data-driven Risk Analysis of Sustainable Cloud Infrastructure using Simulation](https://repository.tudelft.nl/islandora/object/uuid:00afeb36-724d-4edf-adc7-67ce991c7d12)
+ **Master Thesis, 2022**
+ Fabian Mastenbroek
+2. [How Can Datacenters Join the Smart Grid to Address the Climate Crisis?](https://arxiv.org/abs/2108.01776)
+ **Bachelor Thesis, 2021**
+ Hongyu He
+3. [Capelin: Fast Data-Driven Capacity Planning for Cloud Datacenters](https://repository.tudelft.nl/islandora/object/uuid:d6d50861-86a3-4dd3-a13f-42d84db7af66?collection=education)
+ **Master Thesis, 2020**
+ Georgios Andreadis
+4. [Modeling and Simulation of the Google TensorFlow Ecosystem](https://atlarge-research.com/pdfs/lai2020thesis.pdf)
+ **Master Thesis, 2020**
+ Wenchen Lai
+5. [OpenDC Serverless: Design, Implementation and Evaluation of a FaaS Platform Simulator](https://zenodo.org/record/4046675)
+ **Bachelor Thesis, 2020**
+ Soufiane Jounaid
+6. [LEGO, but with Servers: Creating the Building Blocks to Design and Simulate Datacenters](https://atlarge-research.com/pdfs/BSc-Thesis-JACOB_BURLEY_FINAL.pdf)
+ **Bachelor Thesis, 2020**
+ Jacob Burley
+7. [A Trace-Based Validation Study of OpenDC](https://atlarge-research.com/pdfs/2020-12-02_bsc_thesis_jaro_final.pdf)
+ **Bachelor Thesis, 2020**
+ Jaro Bosch
+8. [A Systematic Design Space Exploration of Datacenter Schedulers](https://repository.tudelft.nl/islandora/object/uuid%3A20478016-cc7d-4c87-aa12-25b46f511277?collection=education)
+ **Bachelor Thesis, 2019**
+ Fabian Mastenbroek