schemaVersion: 3 meta: sourceVersionId: 0198141a-afba-7225-8983-28f4a7d6518f # DO NOT CHANGE - Hex uses this to match up project versions when reimporting the file description: "" projectId: 0197cd21-cdf8-700a-b011-1015660ac8e7 # DO NOT CHANGE - Unique ID of the project from which this file was generated title: Hex at {{your company}} guide timezone: null appTheme: SYS_PREF codeLanguage: PYTHON status: name: EXTERNAL categories: - name: Customer Engineering - name: Example Project castDecimalsDefault: true logicQueryCacheTimeout: null publishedQueryCacheTimeout: type: fixed unit: hours duration: 300 hexType: PROJECT allowExecutionReordering: true prerunApp: false cachePublishedAppState: true refreshStalePublishedApp: true autoRerunApp: false projectAssets: dataConnections: [] envVars: [] secrets: [] sharedAssets: secrets: [] vcsPackages: [] dataConnections: [] externalFileIntegrations: [] cells: - cellType: MARKDOWN cellId: 0197cd22-415b-7330-bc2c-5ad316d4c7fa # DO NOT CHANGE - Hex uses this to match up cells when reimporting the file, and detect any changes to existing cells cellLabel: null config: source: |+ # Hex Resources This template can be used to build out a guide to using Hex at your organization. We’ve included a few sections below for inspiration. You will need to update $$\text{\color{blue}{}}$$ and *text in italics* contains instructions for how to use the section. We’ve found this document is most useful when it lives on an internal resource site, like Sharepoint, Confluence, or in Slack, so that it’s easy to maintain close-at-hand for users to access in their stream of work. Alternatively, make a duplicate of this Hex project and put it in your own Hex workspace! Lastly, make sure to ask your users if they have any recommendations or feedback on what would be helpful to include. - cellType: MARKDOWN cellId: 0197cd22-7f59-7330-bc2c-fa4bb4090cfc # DO NOT CHANGE - Hex uses this to match up cells when reimporting the file, and detect any changes to existing cells cellLabel: null config: source: |- ## 🎤 Announcements *Share a list of any timely or relevant announcements, either about Hex specfically or relevant news from your organization.* *For example:* - *AI Agents in Hex are here! [Read more](https://learn.hex.tech/changelog#ai-chat-notebook)* - *Explore data with intuitive UI tools. [Read more](https://learn.hex.tech/docs/share-insights/explore)* - cellType: MARKDOWN cellId: 0197cd23-7a3c-7330-bc2e-69361e3d6b3e # DO NOT CHANGE - Hex uses this to match up cells when reimporting the file, and detect any changes to existing cells cellLabel: null config: source: | # 📌 Start Here ## 📊 What is Hex? We’re so glad you asked! Hex is an integrated environment that helps you do amazing work with data, whether you're using SQL, Python, or no-code features. Hex combines the best of traditional data science notebooks, with integrated AI assist, easy-to-build data apps and reports, and advanced collaboration, so your data and business teams can use data in new ways. Read more about what Hex is and what it can do [here](https://learn.hex.tech/docs/#the-fastest-way-to-work-with-data-together), or watch a [four-minute video](https://learn.hex.tech/tutorials/video-library/hex-foundations/course-overview)! ## 🧹 Housekeeping $$\text{\color{blue}{}}$$ Request Access to Hex: Slack $$\text{\color{blue}{}}$$ or open a ticket in $$\text{\color{blue}{}}$$ ## 🏗️ Getting Set Up in Hex - Set Your User Preferences: [Read Hex’s docs on this here!](https://learn.hex.tech/docs/administration/user-settings) - Stay Updated: [View notifications in Hex](https://learn.hex.tech/changelog#notification-center) - Find Content Quickly: Use Hex’s [Workspace Search](https://learn.hex.tech/docs/organize-content/workspace-search) - Four-step Quick Start: [Getting Started in Hex](https://learn.hex.tech/tutorials/quickstart/hex-basics) - cellType: MARKDOWN cellId: 0197cd38-2d2e-7330-bc35-c4cfea03090e # DO NOT CHANGE - Hex uses this to match up cells when reimporting the file, and detect any changes to existing cells cellLabel: null config: source: |+ # 🤝 Support ## ☘️ Hex Contacts Account Executive: $$\text{\color{blue}{}}$$ Customer Engineer: $$\text{\color{blue}{}}$$ ## 📬 $$\text{\color{blue}{}}$$ Contacts Hex Admins: - $$\text{\color{blue}{}}$$ - $$\text{\color{blue}{}}$$ - $$\text{\color{blue}{}}$$ ## 🆘 Ask a Question! Hex support is available from 9am-5pm PT and can be reached directly inside a Hex project using the **Help & support** button (includes in-app chat, ability to Share project with support team), and over email using **support@hex.tech**. - cellType: MARKDOWN cellId: 0197cd3e-8837-7330-bc37-ceda95c63c6c # DO NOT CHANGE - Hex uses this to match up cells when reimporting the file, and detect any changes to existing cells cellLabel: null config: source: | # 📚 Best Practices & Resources ## 💐 When to Use Hex *Define which use cases you want teams to put into Hex, and which ones should go to other tools. Some customers have found it useful to include a short flow chart or series of questions to help users determine this.* ## 📝 Hex Formatting Guide *Use this section to define or link to specific formatting requirements for Hex projects at your organization. For example, it can include requirements like “All projects must have a description. All published apps must make sure the ‘last published’ metadata tag is visible.”* ## 🖇️ Hex Version Control & Review Process *Use this section to tell users what process they need to follow when publishing production-worthy assets to your organization. It should include details around requiring reviews, saving and naming versions, and labeling with the appropriate statuses and categories.* ## 🧭 Content Catalog *Add a brief table of the different types of reports and data connections users have available to them in Hex here. If you have an enterprise data catalog where this already exists, feel free to link to it from here.* - cellType: MARKDOWN cellId: 0197cd3f-bd0f-7330-bc3c-c172d1623738 # DO NOT CHANGE - Hex uses this to match up cells when reimporting the file, and detect any changes to existing cells cellLabel: null config: source: | # 🚦 Status, Category, and Collections Dictionary *Add a brief description of each custom status, category, and collection available for use in Hex and the process for using them.* *Below, find an example of how we might do this for statuses:* |Status Name | Endorsed? | Reviews Required? | When to Use It | | :--- | :--- | :-- | :-- | |In Progress | No | No | Apps currently in development, use this status to indicate an app that might not (yet) be all the way baked| |Exploratory | Yes | No | Apps exploring a specific question that produce an interesting insight at a moment in time. Examples: one off analyses or insights generated to make a specific decision. | Trusted | Yes | Yes | Apps that have broad relevance to the company or a particular function. Use metrics whose definitions are agreed on and documented. - cellType: MARKDOWN cellId: 0197cd43-599f-7330-bc4a-66181b560173 # DO NOT CHANGE - Hex uses this to match up cells when reimporting the file, and detect any changes to existing cells cellLabel: null config: source: |+ # 📹 Videos Beginner: [Hex Foundations](https://www.youtube.com/playlist?list=PLB_A53wXEFlo-rL8Gbqv387wMjB1K6mkX) Intermediate: [How to Hex](https://www.youtube.com/playlist?list=PLB_A53wXEFlpd-TrN6WJOz68zeg9dBz1m) Advanced: [Select Series](https://www.youtube.com/playlist?list=PLB_A53wXEFlpXfCSIZOFJzPRZ8UZHjlmz) Monthly Demo Series: [How to Hex Live!](https://hex.tech/how-to-hex/) - cellType: MARKDOWN cellId: 0197cd4d-584c-7330-bc73-151ca090d31f # DO NOT CHANGE - Hex uses this to match up cells when reimporting the file, and detect any changes to existing cells cellLabel: null config: source: |- # 🗃️ Documentation [Hex Docs Site](https://learn.hex.tech/docs) [Hex Tutorials](https://learn.hex.tech/tutorials) [Hex Changelog](https://learn.hex.tech/changelog) [Hex Template Library](https://hex.tech/templates/) [Hex Blog](https://hex.tech/blog/) appLayout: visibleMetadataFields: - NAME - DESCRIPTION - AUTHOR - LAST_EDITED - LAST_RUN - CATEGORIES - STATUS - TABLE_OF_CONTENTS fullWidth: false tabs: - name: Tab 1 rows: - columns: - start: 0 end: 120 elements: - showSource: false hideOutput: false type: CELL cellId: 0197cd22-415b-7330-bc2c-5ad316d4c7fa sharedFilterId: null height: null showLabel: true - columns: - start: 0 end: 120 elements: - showSource: false hideOutput: false type: CELL cellId: 0197cd22-7f59-7330-bc2c-fa4bb4090cfc sharedFilterId: null height: null showLabel: true - columns: - start: 0 end: 120 elements: - showSource: false hideOutput: false type: CELL cellId: 0197cd23-7a3c-7330-bc2e-69361e3d6b3e sharedFilterId: null height: null showLabel: true - columns: - start: 0 end: 120 elements: - showSource: false hideOutput: false type: CELL cellId: 0197cd38-2d2e-7330-bc35-c4cfea03090e sharedFilterId: null height: null showLabel: true - columns: - start: 0 end: 120 elements: - showSource: false hideOutput: false type: CELL cellId: 0197cd3e-8837-7330-bc37-ceda95c63c6c sharedFilterId: null height: null showLabel: true - columns: - start: 0 end: 120 elements: - showSource: false hideOutput: false type: CELL cellId: 0197cd3f-bd0f-7330-bc3c-c172d1623738 sharedFilterId: null height: null showLabel: true - columns: - start: 0 end: 60 elements: - showSource: false hideOutput: false type: CELL cellId: 0197cd43-599f-7330-bc4a-66181b560173 sharedFilterId: null height: null showLabel: true - start: 60 end: 120 elements: - showSource: false hideOutput: false type: CELL cellId: 0197cd4d-584c-7330-bc73-151ca090d31f sharedFilterId: null height: null showLabel: true sharedFilters: []