Github releases

Having trouble installing or compiling FreeCAD? Get help here.
User avatar
Kunda1
Posts: 3669
Joined: Thu Jan 05, 2017 9:03 pm

Re: Github releases

Postby Kunda1 » Fri Feb 08, 2019 5:22 pm

sgrogan wrote:
Thu Jan 31, 2019 12:46 am
I'll take any input.
How about:

Code: Select all

## FreeCAD Development builds

**tl;dr**  
FreeCAD development builds for Linux, MacOS, and Windows.   
`FreeCAD-<dev-version>-<revision>.extension` (revision = github commit count number)  
**Important Note:** Not all development builds are built daily. Also, the source archives (`tar.gz` and `.zip`) do not get updated and are therefore obsolete.

### MacOSX and Windows
Binary developer builds (no compiling necessary) are available.  

### Linux 
[AppImages](https://www.freecadweb.org/wiki/Appimage) are available (a kind of binary that can run on many Linux distros). Please note that we prefer users download the Python3/Qt5 Conda AppImage and [report bugs](https://forum.freecadweb.org/viewtopic.php?f=10&t=12534).

#### AppImage (delta) updates
For more streamlined downloading of AppImages [download](https://github.com/AppImage/AppImageUpdate/releases) AppImageUpdate (GUI or the command line version). To perform an update:

```bash
# Using GUI
chmod +x ./AppImageUpdate.AppImage
./AppImageUpdate.AppImage ./FreeCAD.AppImage
# Command line
chmod +x ./appimageupdatetool.AppImage
./appimageupdatetool.AppImage ./FreeCAD.AppImage
```
Github-Release-Text.png
Github-Release-Text.png (99.22 KiB) Viewed 217 times
Last edited by Kunda1 on Thu Feb 14, 2019 12:31 pm, edited 2 times in total.
Want to contribute back to FC? Checkout:
#lowhangingfruit | Use the Source, Luke. | How to Help FreeCAD | How to report FC bugs and features
User avatar
uwestoehr
Posts: 118
Joined: Sun Jan 27, 2019 3:21 am

Re: Github releases

Postby uwestoehr » Wed Feb 13, 2019 11:50 pm

This reads good, only few remarks:
Kunda1 wrote:
Fri Feb 08, 2019 5:22 pm
**tl;dr**
What does that mean?
Kunda1 wrote:
Fri Feb 08, 2019 5:22 pm
**Important Note:** Not all dev builds are built daily.
Please write it out: "development build"
Kunda1 wrote:
Fri Feb 08, 2019 5:22 pm
Please note that we prefer users d/l the Py3/Qt5 Conda AppImage
What means "d/l"? I guess and thus please use "to download". Also please write out "Python 3".

I think with these changes it is better understandable for average users.
User avatar
NormandC
Posts: 17779
Joined: Sat Feb 06, 2010 9:52 pm
Location: Québec, Canada

Re: Github releases

Postby NormandC » Thu Feb 14, 2019 6:12 am

uwestoehr wrote:
Wed Feb 13, 2019 11:50 pm
What does that mean?
A quick web search would have told you ;)
too long; didn't read
It's a prefix to a one-line summary, for those who can't be bothered to read more that 3 sentences. :roll:

I agree with your other points.
User avatar
Kunda1
Posts: 3669
Joined: Thu Jan 05, 2017 9:03 pm

Re: Github releases

Postby Kunda1 » Thu Feb 14, 2019 12:32 pm

uwestoehr wrote:
Wed Feb 13, 2019 11:50 pm
I think with these changes it is better understandable for average users.
Added. Thanks for the feedback, guys.
Want to contribute back to FC? Checkout:
#lowhangingfruit | Use the Source, Luke. | How to Help FreeCAD | How to report FC bugs and features
User avatar
uwestoehr
Posts: 118
Joined: Sun Jan 27, 2019 3:21 am

Re: Github releases

Postby uwestoehr » Thu Feb 14, 2019 1:06 pm

NormandC wrote:
Thu Feb 14, 2019 6:12 am
A quick web search would have told you ;)
Of course I was curious and googled it. but a download page should not use terms average users like me have to google first to understand what they mean. Also many users are no native speaker thus please use simple English on the download page.

S0 instead of tl;dr, maybe "short summary"
User avatar
NormandC
Posts: 17779
Joined: Sat Feb 06, 2010 9:52 pm
Location: Québec, Canada

Re: Github releases

Postby NormandC » Sat Feb 16, 2019 6:20 am

Okay, I understand your point and I agree.