Wiki source code of From Google Workspace to XWiki: A Practical Transition Guide
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
| |
1.2 | 1 | {{velocity}} |
| 2 | #set ($discard = $xwiki.ssx.use('PublicWebSite.WebHome')) | ||
| |
4.2 | 3 | |
| 4 | #set ($summaryCards = [{ | ||
| 5 | 'icon': 'book', | ||
| 6 | 'title': 'Use XWiki for trusted knowledge', | ||
| 7 | 'content': 'Move official documentation, policies, procedures, decisions, meeting outcomes, working group spaces and maintained knowledge into XWiki.' | ||
| 8 | },{ | ||
| 9 | 'icon': 'pencil', | ||
| 10 | 'title': 'Keep specialist tools where needed', | ||
| 11 | 'content': 'Do not force XWiki to replace email, calendar, video calls, chat, desktop file sync, complex spreadsheets or presentation editing.' | ||
| 12 | },{ | ||
| 13 | 'icon': 'road', | ||
| 14 | 'title': 'Transition gradually', | ||
| 15 | 'content': 'Start with one useful pilot space, define templates and ownership rules, then expand once users see XWiki as the trusted source.' | ||
| 16 | }]) | ||
| 17 | |||
| 18 | #set ($xwikiFitCards = [{ | ||
| 19 | 'icon': 'sitemap', | ||
| 20 | 'title': 'Structured knowledge spaces', | ||
| 21 | 'content': 'Create clear spaces for teams, working groups, committees, projects, departments or public documentation areas.' | ||
| 22 | },{ | ||
| 23 | 'icon': 'file-text-o', | ||
| 24 | 'title': 'Official pages and procedures', | ||
| 25 | 'content': 'Turn important documents into maintained wiki pages with history, ownership, review dates and clear navigation.' | ||
| 26 | },{ | ||
| 27 | 'icon': 'check-square-o', | ||
| 28 | 'title': 'Decision records', | ||
| 29 | 'content': 'Capture decisions separately from chats, meetings and drafts so users can understand why something was agreed later.' | ||
| 30 | },{ | ||
| 31 | 'icon': 'users', | ||
| 32 | 'title': 'Working group collaboration', | ||
| 33 | 'content': 'Provide each group with a homepage, meeting notes, decisions, files, responsibilities and links to external tools.' | ||
| 34 | },{ | ||
| 35 | 'icon': 'database', | ||
| 36 | 'title': 'Lightweight structured apps', | ||
| 37 | 'content': 'Replace some spreadsheet-based lists with XWiki applications when the data has stable fields, owners and lifecycle rules.' | ||
| 38 | },{ | ||
| 39 | 'icon': 'shield', | ||
| 40 | 'title': 'Governed access', | ||
| 41 | 'content': 'Use XWiki groups, rights and page hierarchy to create a more explicit model for internal, restricted and public knowledge.' | ||
| 42 | }]) | ||
| 43 | |||
| 44 | #set ($notXWikiCards = [{ | ||
| 45 | 'icon': 'envelope-o', | ||
| 46 | 'title': 'Email and calendar', | ||
| 47 | 'content': 'XWiki is not a mail or scheduling platform. Keep the existing groupware or evaluate tools such as Nextcloud Groupware for calendar and contacts.' | ||
| 48 | },{ | ||
| 49 | 'icon': 'comments-o', | ||
| 50 | 'title': 'Real-time chat', | ||
| 51 | 'content': 'XWiki comments and notifications do not replace chat. Use Matrix/Element, Mattermost, Nextcloud Talk or another dedicated messaging tool.' | ||
| 52 | },{ | ||
| 53 | 'icon': 'video-camera', | ||
| 54 | 'title': 'Video meetings', | ||
| 55 | 'content': 'XWiki can store agendas and notes, but it should not host meetings. Use Jitsi, Nextcloud Talk or another video conferencing solution.' | ||
| 56 | },{ | ||
| 57 | 'icon': 'cloud', | ||
| 58 | 'title': 'Large file sync', | ||
| 59 | 'content': 'XWiki attachments are useful around pages, but XWiki is not a desktop file synchronization platform. Use Nextcloud Files for that role.' | ||
| 60 | },{ | ||
| 61 | 'icon': 'table', | ||
| 62 | 'title': 'Complex spreadsheets', | ||
| 63 | 'content': 'Budgets, calculations, pivot tables and reporting workbooks should remain in office tools such as LibreOffice, ONLYOFFICE or Collabora.' | ||
| 64 | },{ | ||
| 65 | 'icon': 'desktop', | ||
| 66 | 'title': 'Presentation editing', | ||
| 67 | 'content': 'XWiki can store final decks and document the reusable knowledge behind them, but presentation authoring belongs in an office suite.' | ||
| 68 | }]) | ||
| 69 | |||
| 70 | #set ($roadmapSteps = [{ | ||
| 71 | 'title': '1. Define the role of XWiki', | ||
| 72 | 'content': 'Agree that XWiki is the trusted knowledge and governance layer, not a clone of Google Workspace.' | ||
| 73 | },{ | ||
| 74 | 'title': '2. Select high-value content', | ||
| 75 | 'content': 'Start with policies, procedures, decisions, working group documents, onboarding guides and maintained knowledge.' | ||
| 76 | },{ | ||
| 77 | 'title': '3. Create templates', | ||
| 78 | 'content': 'Prepare templates for working group homepages, meeting notes, decision records, policies, procedures and FAQs.' | ||
| 79 | },{ | ||
| 80 | 'title': '4. Design permissions', | ||
| 81 | 'content': 'Define public, internal, restricted and external collaboration areas before migrating content.' | ||
| 82 | },{ | ||
| 83 | 'title': '5. Reduce login friction', | ||
| 84 | 'content': 'Connect XWiki to the organization identity provider through OIDC, SAML, LDAP or another SSO approach.' | ||
| 85 | },{ | ||
| 86 | 'title': '6. Migrate into structure', | ||
| 87 | 'content': 'Do not only copy files. Give each page an owner, location, purpose, access model and review expectation.' | ||
| 88 | },{ | ||
| 89 | 'title': '7. Expand after a pilot', | ||
| 90 | 'content': 'Start with one working group or department, collect feedback, improve the structure, then repeat with more teams.' | ||
| 91 | }]) | ||
| 92 | |||
| 93 | #set ($pilotCards = [{ | ||
| 94 | 'icon': 'home', | ||
| 95 | 'title': 'Working group homepage', | ||
| 96 | 'content': 'Purpose, scope, members, priorities, important links and current responsibilities.' | ||
| 97 | },{ | ||
| 98 | 'icon': 'calendar', | ||
| 99 | 'title': 'Meeting notes', | ||
| 100 | 'content': 'Consistent notes with agenda, participants, decisions, actions and links to related pages.' | ||
| 101 | },{ | ||
| 102 | 'icon': 'check', | ||
| 103 | 'title': 'Decisions', | ||
| 104 | 'content': 'Short decision records with context, options considered, decision, owner and date.' | ||
| 105 | },{ | ||
| 106 | 'icon': 'folder-open-o', | ||
| 107 | 'title': 'Documents and files', | ||
| 108 | 'content': 'Important documents converted to pages when possible, with attachments or external links where needed.' | ||
| 109 | },{ | ||
| 110 | 'icon': 'question-circle', | ||
| 111 | 'title': 'Open questions', | ||
| 112 | 'content': 'A visible place for unresolved topics instead of hiding them in chat or email.' | ||
| 113 | },{ | ||
| 114 | 'icon': 'link', | ||
| 115 | 'title': 'External tool links', | ||
| 116 | 'content': 'Clear bridges to Drive, Nextcloud, office editors, issue trackers, chat or other tools still in use.' | ||
| 117 | }]) | ||
| 118 | |||
| 119 | #set ($implementationItems = [ | ||
| 120 | 'Single sign-on with OIDC, SAML, LDAP or another identity provider.', | ||
| 121 | 'A simple space model for departments, working groups, projects and public documentation.', | ||
| 122 | 'Page templates for recurring content types such as meeting notes, decisions, policies and procedures.', | ||
| 123 | 'Metadata fields such as owner, status, review date, audience and document type.', | ||
| 124 | 'Clear group and permission model for public, internal, restricted and external collaboration areas.', | ||
| 125 | 'Notifications and watch rules so users know when important pages change.', | ||
| 126 | 'Structured applications for lists, registers and lightweight internal processes.', | ||
| 127 | 'Optional office document integration when page-based content is not enough.', | ||
| 128 | 'A migration dashboard showing selected content, owners, status and unresolved questions.' | ||
| 129 | ]) | ||
| 130 | |||
| |
1.2 | 131 | {{html clean="false"}} |
| 132 | |||
| 133 | <section class="resource-header" aria-labelledby="hero-title"> | ||
| 134 | <div class="container"> | ||
| 135 | <div class="text-center"> | ||
| 136 | <div class="hero-kicker"> | ||
| 137 | <i class="fa fa-exchange" aria-hidden="true"></i> | ||
| |
3.2 | 138 | XWiki migration and collaboration guidance |
| |
1.2 | 139 | </div> |
| 140 | </div> | ||
| 141 | |||
| 142 | <h1 id="hero-title">From Google Workspace to XWiki: a practical transition guide</h1> | ||
| 143 | |||
| 144 | <p class="resource-summary"> | ||
| |
3.2 | 145 | A practical guide for moving durable knowledge, documentation and governance from Google Workspace |
| |
4.2 | 146 | into XWiki, while keeping the right tools for files, meetings, chat, office editing and communication. |
| |
1.2 | 147 | </p> |
| 148 | </div> | ||
| 149 | </section> | ||
| 150 | |||
| 151 | <section class="resource-page"> | ||
| 152 | <div class="container"> | ||
| 153 | <div class="resource-layout"> | ||
| 154 | |||
| 155 | <aside class="resource-sidebar" aria-label="Page summary"> | ||
| 156 | <h4>In this guide</h4> | ||
| 157 | <ul> | ||
| 158 | <li><a href="#main-idea">Main idea</a></li> | ||
| |
4.2 | 159 | <li><a href="#quick-view">Quick view</a></li> |
| |
3.2 | 160 | <li><a href="#workspace-map">Google Workspace map</a></li> |
| |
4.2 | 161 | <li><a href="#replacement-map">Replacement map</a></li> |
| |
3.2 | 162 | <li><a href="#what-belongs-in-xwiki">What belongs in XWiki</a></li> |
| |
4.2 | 163 | <li><a href="#not-xwiki">What not to replace</a></li> |
| 164 | <li><a href="#open-source-stack">Open-source stack</a></li> | ||
| |
1.2 | 165 | <li><a href="#transition-plan">Transition plan</a></li> |
| 166 | <li><a href="#pilot">Pilot example</a></li> | ||
| 167 | <li><a href="#adoption">Adoption guidance</a></li> | ||
| |
4.2 | 168 | <li><a href="#implementation">Implementation checklist</a></li> |
| |
3.2 | 169 | <li><a href="#related-resources">Related resources</a></li> |
| |
1.2 | 170 | <li><a href="#faq">FAQ</a></li> |
| 171 | </ul> | ||
| 172 | </aside> | ||
| 173 | |||
| 174 | <article class="resource-content"> | ||
| 175 | |||
| 176 | <p> | ||
| |
3.2 | 177 | Moving an organization away from <a href="https://workspace.google.com/" target="_blank" rel="noopener">Google Workspace</a> |
| |
4.2 | 178 | is rarely just a software migration. It changes habits, ownership, permissions, document lifecycle and the |
| 179 | way people expect collaboration to happen. | ||
| |
1.2 | 180 | </p> |
| 181 | |||
| 182 | <p> | ||
| |
4.2 | 183 | Google Workspace is popular because it combines documents, files, email, calendar, meetings, chat, forms, |
| 184 | sharing and search in one familiar environment. A transition to XWiki should therefore avoid the weak argument | ||
| 185 | that XWiki can replace everything. It cannot, and it should not try to. | ||
| |
1.2 | 186 | </p> |
| 187 | |||
| 188 | <div class="resource-note"> | ||
| 189 | <p> | ||
| |
4.2 | 190 | <strong>The practical position:</strong> XWiki is strongest as the structured knowledge layer. It is the place |
| 191 | for official documentation, maintained knowledge, working group spaces, policies, procedures, decisions, | ||
| 192 | governance content and organizational memory. | ||
| |
1.2 | 193 | </p> |
| 194 | </div> | ||
| 195 | |||
| |
4.2 | 196 | <h2 id="main-idea">The main idea: replace the knowledge problem, not the entire suite</h2> |
| 197 | |||
| 198 | <p> | ||
| 199 | The strongest argument for XWiki is not that it imitates Google Workspace. The strongest argument is that it | ||
| 200 | solves a problem that often appears inside Google Workspace over time: scattered documents, unclear ownership, | ||
| 201 | duplicated files, weak navigation, old links, inconsistent permissions and no obvious place for the trusted | ||
| 202 | version of important knowledge. | ||
| 203 | </p> | ||
| 204 | |||
| |
3.2 | 205 | <div class="resource-note"> |
| 206 | <p> | ||
| 207 | <strong>Summary recommendation:</strong> use XWiki as the trusted knowledge and governance layer. Move official | ||
| 208 | documentation, procedures, decisions, policies, meeting outcomes and maintained knowledge into XWiki. Keep | ||
| 209 | real-time office editing, email, calendar, chat, video meetings and large file sync in dedicated tools that | ||
| 210 | can integrate with or link back to XWiki. | ||
| 211 | </p> | ||
| 212 | </div> | ||
| 213 | |||
| |
4.3 | 214 | <div class="resource-inline-cta"> |
| 215 | <div> | ||
| 216 | <h3>Need a transition plan your team can agree on?</h3> | ||
| 217 | <p> | ||
| 218 | Agnease can help map current Google Workspace usage, identify what should move to XWiki, | ||
| 219 | define the right open-source alternatives, and prepare a realistic pilot migration. | ||
| 220 | </p> | ||
| 221 | </div> | ||
| 222 | |||
| 223 | <a class="btn btn-primary" href="$xwiki.getURL('contact.WebHome')"> | ||
| 224 | Discuss your transition | ||
| 225 | </a> | ||
| 226 | </div> | ||
| 227 | |||
| |
4.2 | 228 | <h2 id="quick-view">Quick view: how to position the transition</h2> |
| |
1.2 | 229 | |
| |
4.2 | 230 | <div class="services-grid resources-grid"> |
| 231 | #foreach ($entry in $summaryCards) | ||
| 232 | <article class="service resource-card"> | ||
| 233 | <div class="service-icon" aria-hidden="true"> | ||
| 234 | <i class="fa fa-$entry.icon"></i> | ||
| 235 | </div> | ||
| 236 | <div class="service-body"> | ||
| 237 | <h4>$entry.title</h4> | ||
| 238 | <p>$entry.content</p> | ||
| 239 | </div> | ||
| 240 | </article> | ||
| 241 | #end | ||
| |
1.2 | 242 | </div> |
| 243 | |||
| 244 | <h2 id="workspace-map">What Google Workspace usually provides</h2> | ||
| 245 | |||
| 246 | <p> | ||
| |
4.2 | 247 | Before proposing a transition, it is useful to explain what people currently get from Google Workspace. |
| 248 | Users are not only using a document editor. They are using a complete collaboration habit. | ||
| |
1.2 | 249 | </p> |
| 250 | |||
| 251 | <table class="table table-bordered table-striped"> | ||
| 252 | <thead> | ||
| 253 | <tr> | ||
| 254 | <th>Google Workspace area</th> | ||
| |
4.2 | 255 | <th>What users value</th> |
| 256 | <th>Risk over time</th> | ||
| |
1.2 | 257 | </tr> |
| 258 | </thead> | ||
| 259 | <tbody> | ||
| 260 | <tr> | ||
| 261 | <td>Google Docs</td> | ||
| 262 | <td>Fast writing, real-time editing, comments and suggestions.</td> | ||
| |
4.2 | 263 | <td>Important documents become isolated files instead of maintained knowledge.</td> |
| |
1.2 | 264 | </tr> |
| 265 | <tr> | ||
| 266 | <td>Google Drive</td> | ||
| |
4.2 | 267 | <td>Easy sharing, folders, file ownership and external collaboration.</td> |
| 268 | <td>Folder structures grow organically and become hard to govern.</td> | ||
| |
1.2 | 269 | </tr> |
| 270 | <tr> | ||
| 271 | <td>Google Sheets</td> | ||
| |
4.2 | 272 | <td>Trackers, lists, budgets, lightweight databases and reports.</td> |
| 273 | <td>Business processes become hidden in spreadsheets.</td> | ||
| |
1.2 | 274 | </tr> |
| 275 | <tr> | ||
| 276 | <td>Google Slides</td> | ||
| 277 | <td>Presentation creation and sharing.</td> | ||
| |
4.2 | 278 | <td>Reusable knowledge remains locked in slide decks.</td> |
| |
1.2 | 279 | </tr> |
| 280 | <tr> | ||
| 281 | <td>Google Forms</td> | ||
| |
4.2 | 282 | <td>Quick surveys, registrations and data collection.</td> |
| 283 | <td>Collected data may remain detached from internal processes.</td> | ||
| |
1.2 | 284 | </tr> |
| 285 | <tr> | ||
| 286 | <td>Google Sites</td> | ||
| 287 | <td>Simple internal or public pages.</td> | ||
| |
4.2 | 288 | <td>Content can be separated from the wider knowledge base.</td> |
| |
1.2 | 289 | </tr> |
| 290 | <tr> | ||
| 291 | <td>Gmail, Calendar, Meet and Chat</td> | ||
| 292 | <td>Communication, scheduling, meetings and quick coordination.</td> | ||
| |
4.2 | 293 | <td>Decisions remain scattered in messages, calls and informal conversations.</td> |
| |
1.2 | 294 | </tr> |
| 295 | </tbody> | ||
| 296 | </table> | ||
| 297 | |||
| |
4.2 | 298 | <h2 id="replacement-map">What can move to XWiki, and what should move elsewhere</h2> |
| |
1.2 | 299 | |
| 300 | <p> | ||
| |
4.2 | 301 | A successful transition separates content by purpose. Some content belongs naturally in XWiki. Some should |
| 302 | remain in office collaboration tools. Some should move to other open-source or self-hostable systems that | ||
| 303 | complement XWiki. | ||
| |
1.2 | 304 | </p> |
| 305 | |||
| 306 | <table class="table table-bordered table-striped"> | ||
| 307 | <thead> | ||
| 308 | <tr> | ||
| 309 | <th>Current Google Workspace usage</th> | ||
| |
4.2 | 310 | <th>Recommended destination</th> |
| 311 | <th>Transition guidance</th> | ||
| |
1.2 | 312 | </tr> |
| 313 | </thead> | ||
| 314 | <tbody> | ||
| 315 | <tr> | ||
| 316 | <td>Official documentation in Google Docs</td> | ||
| |
4.2 | 317 | <td>XWiki pages, spaces, page history, comments and permissions.</td> |
| 318 | <td>Move final and maintained documentation into XWiki pages.</td> | ||
| |
1.2 | 319 | </tr> |
| 320 | <tr> | ||
| 321 | <td>Policies, procedures and governance documents</td> | ||
| |
4.2 | 322 | <td>XWiki pages with templates, metadata, review dates and ownership.</td> |
| |
1.2 | 323 | <td>Move to XWiki and add lifecycle rules.</td> |
| 324 | </tr> | ||
| 325 | <tr> | ||
| 326 | <td>Meeting notes</td> | ||
| 327 | <td>XWiki meeting note templates inside team or working group spaces.</td> | ||
| |
4.2 | 328 | <td>Start new meeting notes in XWiki and link older notes only when useful.</td> |
| |
1.2 | 329 | </tr> |
| 330 | <tr> | ||
| 331 | <td>Working group or committee documents</td> | ||
| |
4.2 | 332 | <td>XWiki spaces with homepage, members, notes, decisions and documents.</td> |
| |
1.2 | 333 | <td>Create one structured space per group.</td> |
| 334 | </tr> | ||
| 335 | <tr> | ||
| 336 | <td>Decision records</td> | ||
| |
4.2 | 337 | <td>XWiki decision page template.</td> |
| |
1.2 | 338 | <td>Move decisions out of scattered Docs, email and chat.</td> |
| 339 | </tr> | ||
| 340 | <tr> | ||
| 341 | <td>Google Sites pages</td> | ||
| |
4.2 | 342 | <td>XWiki public or private spaces.</td> |
| 343 | <td>Move informational pages that need history, permissions or governance.</td> | ||
| |
1.2 | 344 | </tr> |
| 345 | <tr> | ||
| 346 | <td>Shared file archive</td> | ||
| |
4.2 | 347 | <td>XWiki attachments for curated files; <a href="https://nextcloud.com/files/" target="_blank" rel="noopener">Nextcloud Files</a> for general file sharing.</td> |
| 348 | <td>Use XWiki for files attached to knowledge pages, not for massive file sync.</td> | ||
| |
1.2 | 349 | </tr> |
| 350 | <tr> | ||
| 351 | <td>Simple trackers in Google Sheets</td> | ||
| |
3.2 | 352 | <td>XWiki structured applications, <a href="https://extensions.xwiki.org/xwiki/bin/view/Extension/App%20Within%20Minutes%20Application" target="_blank" rel="noopener">App Within Minutes</a> or custom XWiki apps.</td> |
| |
4.2 | 353 | <td>Move recurring lists with stable fields and clear ownership.</td> |
| |
1.2 | 354 | </tr> |
| 355 | <tr> | ||
| 356 | <td>Collaborative drafting in Google Docs</td> | ||
| |
4.2 | 357 | <td>XWiki pages for final content; <a href="https://www.onlyoffice.com/docs" target="_blank" rel="noopener">ONLYOFFICE Docs</a> or <a href="https://www.collaboraonline.com/" target="_blank" rel="noopener">Collabora Online</a> for office editing.</td> |
| 358 | <td>Use XWiki for the maintained version, not every draft.</td> | ||
| |
1.2 | 359 | </tr> |
| 360 | <tr> | ||
| 361 | <td>Forms and surveys</td> | ||
| |
4.2 | 362 | <td>XWiki forms for internal processes; <a href="https://www.limesurvey.org/" target="_blank" rel="noopener">LimeSurvey</a> for advanced surveys.</td> |
| 363 | <td>Use the right tool depending on whether it is workflow data or survey data.</td> | ||
| |
1.2 | 364 | </tr> |
| 365 | </tbody> | ||
| 366 | </table> | ||
| 367 | |||
| 368 | <h2 id="what-belongs-in-xwiki">What belongs naturally in XWiki</h2> | ||
| 369 | |||
| 370 | <p> | ||
| 371 | XWiki is a strong destination for information that should be easy to find, maintain, discuss, review and trust | ||
| 372 | over time. | ||
| 373 | </p> | ||
| 374 | |||
| |
4.2 | 375 | <div class="services-grid resources-grid"> |
| 376 | #foreach ($entry in $xwikiFitCards) | ||
| 377 | <article class="service resource-card"> | ||
| 378 | <div class="service-icon" aria-hidden="true"> | ||
| 379 | <i class="fa fa-$entry.icon"></i> | ||
| 380 | </div> | ||
| 381 | <div class="service-body"> | ||
| 382 | <h4>$entry.title</h4> | ||
| 383 | <p>$entry.content</p> | ||
| 384 | </div> | ||
| 385 | </article> | ||
| 386 | #end | ||
| 387 | </div> | ||
| |
1.2 | 388 | |
| 389 | <h2 id="not-xwiki">What should not be replaced by XWiki</h2> | ||
| 390 | |||
| 391 | <p> | ||
| 392 | A credible transition guide should clearly explain where XWiki is not the right tool. This avoids unrealistic | ||
| |
3.2 | 393 | expectations and helps the organization design a better collaboration stack. |
| |
1.2 | 394 | </p> |
| 395 | |||
| |
4.2 | 396 | <div class="services-grid resources-grid"> |
| 397 | #foreach ($entry in $notXWikiCards) | ||
| 398 | <article class="service resource-card"> | ||
| 399 | <div class="service-icon" aria-hidden="true"> | ||
| 400 | <i class="fa fa-$entry.icon"></i> | ||
| 401 | </div> | ||
| 402 | <div class="service-body"> | ||
| 403 | <h4>$entry.title</h4> | ||
| 404 | <p>$entry.content</p> | ||
| 405 | </div> | ||
| 406 | </article> | ||
| 407 | #end | ||
| 408 | </div> | ||
| |
1.2 | 409 | |
| 410 | <div class="resource-note"> | ||
| 411 | <p> | ||
| 412 | <strong>In practice:</strong> the goal is not to make XWiki do everything. The goal is to make XWiki the | ||
| 413 | trusted home for maintained knowledge, while integrating or linking to the right tools for files, office | ||
| 414 | editing, chat, meetings and identity. | ||
| 415 | </p> | ||
| 416 | </div> | ||
| 417 | |||
| 418 | <h2 id="open-source-stack">Open-source alternatives that can complement XWiki</h2> | ||
| 419 | |||
| 420 | <p> | ||
| |
4.2 | 421 | For organizations trying to reduce dependency on Google Workspace, XWiki can become part of a broader |
| 422 | open-source collaboration architecture. The exact stack depends on hosting preferences, support needs, | ||
| 423 | security requirements and user expectations. | ||
| |
1.2 | 424 | </p> |
| 425 | |||
| 426 | <table class="table table-bordered table-striped"> | ||
| 427 | <thead> | ||
| 428 | <tr> | ||
| |
4.2 | 429 | <th>Need</th> |
| 430 | <th>Possible solution</th> | ||
| |
1.2 | 431 | <th>How it works with XWiki</th> |
| 432 | </tr> | ||
| 433 | </thead> | ||
| 434 | <tbody> | ||
| 435 | <tr> | ||
| 436 | <td>Structured knowledge base</td> | ||
| |
3.2 | 437 | <td><a href="https://www.xwiki.org/" target="_blank" rel="noopener">XWiki</a></td> |
| |
4.2 | 438 | <td>Main platform for documentation, governance, knowledge management and structured content.</td> |
| |
1.2 | 439 | </tr> |
| 440 | <tr> | ||
| |
4.2 | 441 | <td>File sync and sharing</td> |
| |
3.2 | 442 | <td><a href="https://nextcloud.com/files/" target="_blank" rel="noopener">Nextcloud Files</a></td> |
| |
4.2 | 443 | <td>Use for general file storage and sharing; link important files from XWiki pages.</td> |
| |
1.2 | 444 | </tr> |
| 445 | <tr> | ||
| 446 | <td>Office document editing</td> | ||
| |
3.2 | 447 | <td><a href="https://www.onlyoffice.com/docs" target="_blank" rel="noopener">ONLYOFFICE Docs</a> or <a href="https://www.collaboraonline.com/" target="_blank" rel="noopener">Collabora Online</a></td> |
| |
4.2 | 448 | <td>Use for documents, spreadsheets and presentations that need office-style editing.</td> |
| |
1.2 | 449 | </tr> |
| 450 | <tr> | ||
| 451 | <td>Chat and team messaging</td> | ||
| |
4.2 | 452 | <td><a href="https://element.io/" target="_blank" rel="noopener">Matrix/Element</a> or <a href="https://mattermost.com/" target="_blank" rel="noopener">Mattermost</a></td> |
| 453 | <td>Use for real-time conversation; move durable decisions and outcomes back into XWiki.</td> | ||
| |
1.2 | 454 | </tr> |
| 455 | <tr> | ||
| 456 | <td>Video meetings</td> | ||
| |
4.2 | 457 | <td><a href="https://jitsi.org/" target="_blank" rel="noopener">Jitsi</a> or <a href="https://nextcloud.com/talk/" target="_blank" rel="noopener">Nextcloud Talk</a></td> |
| |
1.2 | 458 | <td>Use for calls; store agendas, notes and decisions in XWiki.</td> |
| 459 | </tr> | ||
| 460 | <tr> | ||
| 461 | <td>Surveys and advanced forms</td> | ||
| |
3.2 | 462 | <td><a href="https://www.limesurvey.org/" target="_blank" rel="noopener">LimeSurvey</a></td> |
| |
4.2 | 463 | <td>Use for survey campaigns; publish results, summaries or procedures in XWiki.</td> |
| |
1.2 | 464 | </tr> |
| 465 | <tr> | ||
| 466 | <td>Identity and SSO</td> | ||
| |
4.2 | 467 | <td><a href="https://www.keycloak.org/" target="_blank" rel="noopener">Keycloak</a>, Microsoft Entra ID, Google identity or another OIDC/SAML provider.</td> |
| |
1.2 | 468 | <td>Use SSO so users access XWiki without a separate password and with mapped groups where appropriate.</td> |
| 469 | </tr> | ||
| 470 | </tbody> | ||
| 471 | </table> | ||
| 472 | |||
| 473 | <h2 id="transition-plan">A practical transition plan</h2> | ||
| 474 | |||
| 475 | <p> | ||
| 476 | The safest transition is gradual. The organization should not begin by migrating every Google Drive folder. | ||
| 477 | That approach creates too much noise, too many permission questions and too many low-value documents. | ||
| 478 | </p> | ||
| 479 | |||
| |
4.2 | 480 | <ol class="process-list"> |
| 481 | #foreach ($entry in $roadmapSteps) | ||
| 482 | <li> | ||
| 483 | <strong>$entry.title</strong> | ||
| 484 | $entry.content | ||
| 485 | </li> | ||
| 486 | #end | ||
| 487 | </ol> | ||
| |
1.2 | 488 | |
| |
4.2 | 489 | <h2 id="pilot">A good pilot: one working group space</h2> |
| 490 | |||
| |
1.2 | 491 | <p> |
| |
4.2 | 492 | A strong pilot is small enough to control but useful enough to prove value. For example, one working group, |
| 493 | committee, project team or community group can move its durable knowledge into XWiki while keeping office | ||
| 494 | tools for drafting, spreadsheets and presentations when needed. | ||
| |
1.2 | 495 | </p> |
| 496 | |||
| |
4.2 | 497 | <div class="services-grid resources-grid"> |
| 498 | #foreach ($entry in $pilotCards) | ||
| 499 | <article class="service resource-card"> | ||
| 500 | <div class="service-icon" aria-hidden="true"> | ||
| 501 | <i class="fa fa-$entry.icon"></i> | ||
| 502 | </div> | ||
| 503 | <div class="service-body"> | ||
| 504 | <h4>$entry.title</h4> | ||
| 505 | <p>$entry.content</p> | ||
| 506 | </div> | ||
| 507 | </article> | ||
| 508 | #end | ||
| 509 | </div> | ||
| 510 | |||
| |
1.2 | 511 | <div class="resource-note"> |
| 512 | <p> | ||
| |
4.2 | 513 | <strong>Pilot success question:</strong> can members find the current and trusted version of important |
| 514 | information faster than before? | ||
| |
1.2 | 515 | </p> |
| 516 | </div> | ||
| 517 | |||
| |
4.2 | 518 | <h2 id="adoption">How to convince the team to use XWiki</h2> |
| 519 | |||
| |
1.2 | 520 | <p> |
| |
4.2 | 521 | People do not usually change collaboration habits because a new platform exists. They change when the new |
| 522 | platform makes an important part of their work easier, clearer or more reliable. | ||
| |
1.2 | 523 | </p> |
| 524 | |||
| 525 | <p> | ||
| |
4.2 | 526 | A useful adoption message is: |
| |
1.2 | 527 | </p> |
| 528 | |||
| |
4.2 | 529 | <div class="resource-note"> |
| 530 | <p> | ||
| 531 | <strong>XWiki is not another folder where files disappear. It is the place where the organization keeps | ||
| 532 | the current version, the owner, the context, the decision and the links around important knowledge.</strong> | ||
| 533 | </p> | ||
| 534 | </div> | ||
| |
1.2 | 535 | |
| 536 | <p> | ||
| |
4.2 | 537 | Simple rules help adoption more than abstract platform arguments: |
| |
1.2 | 538 | </p> |
| 539 | |||
| |
4.2 | 540 | <ul class="resource-checklist"> |
| 541 | <li>If it is official, maintained or reusable, it belongs in XWiki.</li> | ||
| 542 | <li>If it is a temporary draft, it can stay in an office editor until it becomes useful knowledge.</li> | ||
| 543 | <li>If it is a complex spreadsheet, do not force it into XWiki.</li> | ||
| 544 | <li>If it was decided in a meeting or chat, summarize the decision in XWiki.</li> | ||
| 545 | <li>If nobody owns it, do not migrate it as current content.</li> | ||
| 546 | <li>If users need the same answer repeatedly, create or improve an XWiki page.</li> | ||
| |
1.2 | 547 | </ul> |
| 548 | |||
| |
4.2 | 549 | <h2 id="implementation">Practical XWiki features to implement early</h2> |
| |
1.2 | 550 | |
| 551 | <p> | ||
| |
4.2 | 552 | The following improvements can make the transition easier to accept and easier to govern. |
| |
1.2 | 553 | </p> |
| 554 | |||
| |
4.2 | 555 | <ul class="resource-checklist"> |
| 556 | #foreach ($item in $implementationItems) | ||
| 557 | <li>$item</li> | ||
| 558 | #end | ||
| |
1.2 | 559 | </ul> |
| 560 | |||
| |
4.2 | 561 | <h2>Example transition scenarios</h2> |
| |
1.2 | 562 | |
| |
4.2 | 563 | <h3>Scenario 1: Working group documentation</h3> |
| |
1.2 | 564 | <p> |
| |
4.2 | 565 | A working group has Google Docs for agendas, meeting notes, decisions and reference files. In XWiki, this can |
| 566 | become a structured space with a homepage, meeting note template, decision records, document list, open | ||
| 567 | questions and links to files that remain in Nextcloud or another storage system. | ||
| |
1.2 | 568 | </p> |
| 569 | |||
| |
4.2 | 570 | <h3>Scenario 2: Policies and procedures</h3> |
| |
1.2 | 571 | <p> |
| |
4.2 | 572 | Policies stored as Google Docs can become XWiki pages with owner, review date, status, history and restricted |
| 573 | edit rights. This makes it easier to know which version is current and who is responsible for keeping it updated. | ||
| |
1.2 | 574 | </p> |
| 575 | |||
| |
4.2 | 576 | <h3>Scenario 3: Spreadsheet tracker</h3> |
| |
1.2 | 577 | <p> |
| |
4.2 | 578 | A simple Google Sheet used as a list of requests, assets, documents or contacts may become a small XWiki |
| 579 | application when the fields are stable. A complex financial model or reporting workbook should remain in an | ||
| 580 | office spreadsheet tool. | ||
| |
1.2 | 581 | </p> |
| 582 | |||
| |
4.2 | 583 | <h2>Recommended target architecture</h2> |
| |
1.2 | 584 | |
| 585 | <p> | ||
| |
4.2 | 586 | A realistic architecture does not replace every Google Workspace feature with XWiki. It gives each tool a clear role. |
| |
1.2 | 587 | </p> |
| 588 | |||
| 589 | <table class="table table-bordered table-striped"> | ||
| 590 | <thead> | ||
| 591 | <tr> | ||
| 592 | <th>Layer</th> | ||
| 593 | <th>Recommended role</th> | ||
| 594 | </tr> | ||
| 595 | </thead> | ||
| 596 | <tbody> | ||
| 597 | <tr> | ||
| |
4.2 | 598 | <td>XWiki</td> |
| |
1.2 | 599 | <td>Structured knowledge, documentation, governance, working group spaces, policies and decisions.</td> |
| 600 | </tr> | ||
| 601 | <tr> | ||
| |
4.2 | 602 | <td>Nextcloud or equivalent</td> |
| |
1.2 | 603 | <td>General file storage, file sharing, sync clients and optional groupware.</td> |
| 604 | </tr> | ||
| 605 | <tr> | ||
| |
4.2 | 606 | <td>ONLYOFFICE, Collabora or LibreOffice</td> |
| |
1.2 | 607 | <td>Office document editing for documents, spreadsheets and presentations.</td> |
| 608 | </tr> | ||
| 609 | <tr> | ||
| |
4.2 | 610 | <td>Matrix/Element, Mattermost or Nextcloud Talk</td> |
| |
1.2 | 611 | <td>Real-time messaging and team coordination.</td> |
| 612 | </tr> | ||
| 613 | <tr> | ||
| |
4.2 | 614 | <td>Jitsi or another meeting tool</td> |
| |
1.2 | 615 | <td>Video meetings and calls.</td> |
| 616 | </tr> | ||
| 617 | <tr> | ||
| |
4.2 | 618 | <td>Keycloak or existing identity provider</td> |
| |
1.2 | 619 | <td>SSO, group mapping and identity lifecycle.</td> |
| 620 | </tr> | ||
| 621 | </tbody> | ||
| 622 | </table> | ||
| 623 | |||
| |
3.2 | 624 | <div id="related-resources" class="resource-note related-resources"> |
| 625 | <p><strong>Related Agnease resources:</strong></p> | ||
| 626 | <ul> | ||
| 627 | <li><a href="$xwiki.getURL('services.xwiki-migrations')">XWiki migration services</a></li> | ||
| 628 | <li><a href="$xwiki.getURL('services.xwiki-authentication-access-control')">Authentication and access control for XWiki</a></li> | ||
| 629 | <li><a href="$xwiki.getURL('resources.xwiki-custom-development')">How to customize XWiki without creating upgrade problems</a></li> | ||
| 630 | <li><a href="$xwiki.getURL('resources.xwiki-access-rights-governance')">Why XWiki access rights need a clear governance model</a></li> | ||
| 631 | <li><a href="$xwiki.getURL('resources.xwiki-security-review')">What an XWiki security review should actually include</a></li> | ||
| 632 | </ul> | ||
| 633 | </div> | ||
| 634 | |||
| |
1.2 | 635 | <h2 id="faq">FAQ</h2> |
| 636 | |||
| |
3.2 | 637 | <details class="resource-faq-item" open> |
| 638 | <summary>Can XWiki replace Google Workspace completely?</summary> | ||
| 639 | <p> | ||
| |
4.2 | 640 | Not realistically. XWiki should not be presented as a full replacement for email, calendar, video meetings, |
| 641 | chat, file sync, spreadsheets and presentation editing. It is much better positioned as the structured | ||
| 642 | knowledge and documentation layer. | ||
| |
3.2 | 643 | </p> |
| 644 | </details> | ||
| |
1.2 | 645 | |
| |
3.2 | 646 | <details class="resource-faq-item"> |
| 647 | <summary>Can XWiki replace Google Docs?</summary> | ||
| 648 | <p> | ||
| |
4.2 | 649 | It can replace many Google Docs that are actually long-term documentation: policies, procedures, notes, |
| 650 | decisions, guides and knowledge base articles. For fast real-time drafting or complex office formatting, | ||
| 651 | an office editor such as ONLYOFFICE or Collabora may still be useful. | ||
| |
3.2 | 652 | </p> |
| 653 | </details> | ||
| |
1.2 | 654 | |
| |
3.2 | 655 | <details class="resource-faq-item"> |
| 656 | <summary>Can XWiki replace Google Drive?</summary> | ||
| 657 | <p> | ||
| |
4.2 | 658 | Partially. XWiki can manage attachments around knowledge pages and can support file-oriented applications, |
| 659 | but it should not be treated as a full desktop file sync and sharing platform. Nextcloud is usually a better | ||
| 660 | fit for that role. | ||
| |
3.2 | 661 | </p> |
| 662 | </details> | ||
| |
1.2 | 663 | |
| |
3.2 | 664 | <details class="resource-faq-item"> |
| 665 | <summary>What is the best first step?</summary> | ||
| 666 | <p> | ||
| |
4.2 | 667 | Start with one high-value pilot: a working group, committee, department or project that has real |
| 668 | documentation pain. Create the structure, templates, permissions and migration rules for that pilot before | ||
| 669 | expanding. | ||
| |
3.2 | 670 | </p> |
| 671 | </details> | ||
| |
1.2 | 672 | |
| |
3.2 | 673 | <details class="resource-faq-item"> |
| 674 | <summary>How do you convince users to try XWiki?</summary> | ||
| 675 | <p> | ||
| |
4.2 | 676 | Do not start by saying that XWiki is replacing everything. Start by showing that XWiki gives users a clearer, |
| 677 | more reliable place for trusted knowledge: the current document, the owner, the status, the related decisions | ||
| 678 | and the wider context. | ||
| |
3.2 | 679 | </p> |
| 680 | </details> | ||
| |
1.2 | 681 | |
| |
3.2 | 682 | <details class="resource-faq-item"> |
| 683 | <summary>What should remain outside XWiki during transition?</summary> | ||
| 684 | <p> | ||
| |
4.2 | 685 | Temporary drafts, complex spreadsheets, presentation working files, ongoing external collaborations and |
| 686 | anything without a clear owner can remain outside XWiki until the organization has a reason to migrate or | ||
| 687 | replace that workflow. | ||
| |
3.2 | 688 | </p> |
| 689 | </details> | ||
| |
1.2 | 690 | |
| 691 | </article> | ||
| 692 | </div> | ||
| 693 | </div> | ||
| 694 | </section> | ||
| 695 | |||
| 696 | <section class="cta-section" aria-labelledby="google-workspace-xwiki-cta-title"> | ||
| 697 | <div class="container"> | ||
| 698 | <div class="cta-panel"> | ||
| 699 | <h2 id="google-workspace-xwiki-cta-title">Planning a transition from Google Workspace to XWiki?</h2> | ||
| 700 | <p> | ||
| 701 | Agnease can help evaluate what should move to XWiki, what should remain in office collaboration tools, | ||
| 702 | and how to design the right structure, permissions, templates, SSO and migration approach. | ||
| 703 | </p> | ||
| 704 | <a class="btn btn-primary" href="$xwiki.getURL('contact.WebHome')">Request a consultation</a> | ||
| 705 | </div> | ||
| 706 | </div> | ||
| 707 | </section> | ||
| 708 | |||
| |
3.2 | 709 | <script type="application/ld+json"> |
| 710 | { | ||
| 711 | "@context": "https://schema.org", | ||
| 712 | "@type": "TechArticle", | ||
| 713 | "headline": "From Google Workspace to XWiki: a practical transition guide", | ||
| 714 | "description": "Practical guide for moving durable knowledge from Google Workspace to XWiki, with replacement mapping, open-source alternatives, migration steps and tool limits.", | ||
| 715 | "author": { | ||
| 716 | "@type": "Organization", | ||
| 717 | "name": "Agnease" | ||
| 718 | }, | ||
| 719 | "publisher": { | ||
| 720 | "@type": "Organization", | ||
| 721 | "name": "Agnease", | ||
| 722 | "url": "https://agnease.com/" | ||
| 723 | }, | ||
| 724 | "mainEntityOfPage": "https://agnease.com/bin/resources/from-google-workspace-to-xwiki" | ||
| 725 | } | ||
| 726 | </script> | ||
| 727 | |||
| 728 | <script type="application/ld+json"> | ||
| 729 | { | ||
| 730 | "@context": "https://schema.org", | ||
| 731 | "@type": "FAQPage", | ||
| 732 | "mainEntity": [ | ||
| 733 | { | ||
| 734 | "@type": "Question", | ||
| 735 | "name": "Can XWiki replace Google Workspace completely?", | ||
| 736 | "acceptedAnswer": { | ||
| 737 | "@type": "Answer", | ||
| 738 | "text": "Not realistically. XWiki should not be presented as a full replacement for email, calendar, video meetings, chat, file sync, spreadsheets and presentation editing. It is better positioned as the structured knowledge and documentation layer." | ||
| 739 | } | ||
| 740 | }, | ||
| 741 | { | ||
| 742 | "@type": "Question", | ||
| 743 | "name": "Can XWiki replace Google Docs?", | ||
| 744 | "acceptedAnswer": { | ||
| 745 | "@type": "Answer", | ||
| 746 | "text": "XWiki can replace many Google Docs that are actually long-term documentation, such as policies, procedures, notes, decisions, guides and knowledge base articles. For fast real-time drafting or complex office formatting, an office editor such as ONLYOFFICE or Collabora may still be useful." | ||
| 747 | } | ||
| 748 | }, | ||
| 749 | { | ||
| 750 | "@type": "Question", | ||
| 751 | "name": "Can XWiki replace Google Drive?", | ||
| 752 | "acceptedAnswer": { | ||
| 753 | "@type": "Answer", | ||
| 754 | "text": "Partially. XWiki can manage attachments around knowledge pages and can support file-oriented applications, but it should not be treated as a full desktop file sync and sharing platform. Nextcloud is usually a better fit for that role." | ||
| 755 | } | ||
| 756 | }, | ||
| 757 | { | ||
| 758 | "@type": "Question", | ||
| 759 | "name": "What is the best first step when moving from Google Workspace to XWiki?", | ||
| 760 | "acceptedAnswer": { | ||
| 761 | "@type": "Answer", | ||
| 762 | "text": "Start with one high-value pilot, such as a working group, committee, department or project that has real documentation pain. Create the structure, templates, permissions and migration rules for that pilot before expanding." | ||
| 763 | } | ||
| 764 | }, | ||
| 765 | { | ||
| 766 | "@type": "Question", | ||
| 767 | "name": "What should remain outside XWiki during transition?", | ||
| 768 | "acceptedAnswer": { | ||
| 769 | "@type": "Answer", | ||
| 770 | "text": "Temporary drafts, complex spreadsheets, presentation working files, ongoing external collaborations and anything without a clear owner can remain outside XWiki until the organization has a reason to migrate or replace that workflow." | ||
| 771 | } | ||
| 772 | } | ||
| 773 | ] | ||
| 774 | } | ||
| 775 | </script> | ||
| 776 | |||
| |
1.2 | 777 | {{/html}} |
| 778 | {{/velocity}} |