Add a new migrating section

Author: andydotxyz

content/docs/api/v2/fyne/pkg.md

@@ -5,7 +5,7 @@ slug: (package)
 
 aliases:
 - /api/
-- /api/.html
+- /api/v2/
 - /api/v2.0/
 - /api/v2.0/.html
 - /api/v2.1/

content/docs/faq/_index.md

@@ -1,5 +1,5 @@
 ---
-weight: 10000
+weight: 11000
 title: "Frequently Asked Questions"
 slug: faq
 icon: question_mark

content/docs/faq/layout.md

@@ -3,7 +3,7 @@ layout: page
 title: Layout and Widget Size
 slug: layout
 
-weight: 10010
+weight: 11010
 ---
 
 Intro

content/docs/faq/theme.md

@@ -2,7 +2,7 @@
 title: Theme and Customisation
 slug: theme
 
-weight: 10020
+weight: 11020
 ---
 
 In this page we answer some common questions about the design of Fyne themes and widgets.

content/docs/faq/troubleshoot.md

@@ -2,7 +2,7 @@
 title: Troubleshooting
 slug: troubleshoot
 
-order: 10030
+order: 11030
 ---
 
 Some things can not go as expected during setup or in compiling your first app. We try to address these problems here.

content/docs/migrating/_index.md

@@ -0,0 +1,10 @@
+---
+weight: 10000
+title: "Migrating to Fyne"
+slug: migrating
+
+description: ""
+icon: "compare"
+draft: false
+toc: true
+---

content/docs/migrating/guiintro.md

@@ -0,0 +1,43 @@
+---
+weight: 10001
+title: "GUI Overview"
+slug: guiintro
+
+aliases:
+- /guiintro
+---
+
+Graphical applications are often more complicated to create than web
+based or command line applications. Fyne changes this by utilizing the great design of Go
+to make building beautiful graphical applications simple and fast.
+
+For a graphical application to work we need to create a window and ask
+the app to run. Doing so will start the event handling code that responds
+to user input and updates the screen as our code runs.
+
+This example creates a new application with a single window with the 
+title "Hello". Inside this window we place a single label containing
+the text "Hello Fyne!".
+
+```go
+package main
+
+import (
+	"fyne.io/fyne/v2/app"
+	"fyne.io/fyne/v2/widget"
+)
+
+func main() {
+	myApp := app.New()
+	myWindow := myApp.NewWindow("Hello")
+
+	myWindow.SetContent(widget.NewLabel("Hello Fyne!"))
+
+	myWindow.ShowAndRun()
+}
+```
+
+Once the window content is set we show it and run the application
+(`Window.ShowAndRun()` is a shortcut for `Window.Show()` && `App.Run()`).
+After calling Run() or ShowAndRun() our application will run and the
+function will return after the window has been closed.

content/docs/welcome.md

@@ -15,7 +15,7 @@ leading cross platform apps.
 |:------:|:-------:|:-------:|
 |        If you can't wait to start building your first Fyne app, you should follow our getting started guide.| If you are new to the Go language, we recommend running through the Go tour before returning to the Fyne documentation. | For developers who prefer to learn from videos we have a collection of getting started tutorials on YouTube. |
 | <a href="/started/quick" class="btn btn-primary btn-l">Get Started</a> | <a href="https://go.dev/tour/" class="btn btn-l btn-primary" style="visibility: visible;">Take the Go Tour</a> | <a href="https://www.youtube.com/playlist?list=PLjpijTpXl1_po-ld8jORR9k5NornDNKQk" class="btn btn-l btn-primary">Tutorial Playlist</a> |
-| You can also check out the latest <a href="/api/">API documentation</a>, or if you came here with a question in mind then you may find an answer in the <a href="/faq/">FAQs</a>. | There is also an <a href="/guiintro/">introduction to GUI development</a> if this is your first time building an application. | If you have questions about the videos or want to let us know that one is missing then please <a   title="Submit feedback" href="https://fyne.io/support/">get in touch</a>.|
+| You can also check out the latest <a href="/api/v2/">API documentation</a>, or if you came here with a question in mind then you may find an answer in the <a href="/faq/">FAQs</a>. | There is also an <a href="/guiintro/">introduction to GUI development</a> if this is your first time building an application. | If you have questions about the videos or want to let us know that one is missing then please <a   title="Submit feedback" href="https://fyne.io/support/">get in touch</a>.|
 
 ---