# Hail architecture or design philosophy

**URL:** <https://discuss.hail.is/t/hail-architecture-or-design-philosophy/2141>\
**Category:** Meta\
**Created:** [July 19, 2021, 9:22am UTC](https://discuss.hail.is/t/hail-architecture-or-design-philosophy/2141 "2021-07-19T09:22:44Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![Abhishek](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.hail.is/abhishek/32/570_2.png) [@Abhishek](https://discuss.hail.is/u/Abhishek)\
**Post date:** [July 19, 2021, 9:22am UTC](https://discuss.hail.is/t/hail-architecture-or-design-philosophy/2141/1 "2021-07-19T09:22:44Z")

</div>

Hi,

I am currently trying to understand hail design inside out. However, I couldn’t find any hail design philosophy or architecture document. It could be a workflow diagram as well.

Could you please point me to it?

---

<div class="post-metadata">

**Author:** ![tpoterba](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.hail.is/tpoterba/32/61_2.png) [@tpoterba](https://discuss.hail.is/u/tpoterba)\
**Post date:** [July 19, 2021, 9:37am UTC](https://discuss.hail.is/t/hail-architecture-or-design-philosophy/2141/2 "2021-07-19T09:37:27Z")

</div>

There are some materials on this topic here:

> **[hail-is/hail](https://github.com/hail-is/hail/tree/main/dev-docs)**
>
> main/dev-docs

---

<div class="post-metadata">

**Author:** ![Abhishek](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.hail.is/abhishek/32/570_2.png) [@Abhishek](https://discuss.hail.is/u/Abhishek)\
**Post date:** [July 19, 2021, 9:42am UTC](https://discuss.hail.is/t/hail-architecture-or-design-philosophy/2141/3 "2021-07-19T09:42:02Z")

</div>

Thanks for the material.

Out of curiosity, is there a research paper published by your team on hail?

---

<div class="post-metadata">

**Author:** ![tpoterba](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.hail.is/tpoterba/32/61_2.png) [@tpoterba](https://discuss.hail.is/u/tpoterba)\
**Post date:** [July 19, 2021, 9:44am UTC](https://discuss.hail.is/t/hail-architecture-or-design-philosophy/2141/4 "2021-07-19T09:44:59Z")

</div>

No, there’s not (yet…)

We recognize the benefit for having a paper, but our team generally enjoys writing code more than prose 🙂. It’s also been hard in the past to choose a “stopping point” to write about the architecture – while interfaces have changed very little during the life of Hail 0.2, the backend infrastructure has changed dramatically.

---

<div class="post-metadata">

**Author:** ![Abhishek](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.hail.is/abhishek/32/570_2.png) [@Abhishek](https://discuss.hail.is/u/Abhishek)\
**Post date:** [July 20, 2021, 4:07pm UTC](https://discuss.hail.is/t/hail-architecture-or-design-philosophy/2141/5 "2021-07-20T16:07:20Z")

</div>

On the upgrades side, I was trying to see if there is any `.Changelog` file in GitHub repository. Is there a place where I can see the summary or highlights of upgrades happened during life of Hail 0.2?

---

<div class="post-metadata">

**Author:** ![tpoterba](https://yyz2.discourse-cdn.com/flex036/user_avatar/discuss.hail.is/tpoterba/32/61_2.png) [@tpoterba](https://discuss.hail.is/u/tpoterba)\
**Post date:** [July 20, 2021, 5:52pm UTC](https://discuss.hail.is/t/hail-architecture-or-design-philosophy/2141/6 "2021-07-20T17:52:45Z")

</div>

There’s a changelog on the site, but that’s only for user-facing changes, many of which are minor bugfixes, performance improvements, or minor new features. We don’t have a curated changelog of backend changes.