Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Windows top level build instructions #126

Merged
merged 9 commits into from
Jan 21, 2021
Merged

Conversation

JShep1
Copy link

@JShep1 JShep1 commented Jan 6, 2021

Signed-off-by: John Shepherd john@openrobotics.org

Fixes #96

Signed-off-by: John Shepherd <john@openrobotics.org>
@github-actions github-actions bot added the 🏰 citadel Ignition Citadel label Jan 6, 2021
Signed-off-by: John Shepherd <john@openrobotics.org>
@chapulina chapulina added the documentation Improvements or additions to documentation label Jan 6, 2021
Signed-off-by: John Shepherd <john@openrobotics.org>
@JShep1 JShep1 marked this pull request as ready for review January 7, 2021 20:24
@JShep1 JShep1 requested a review from maryaB-osr as a code owner January 7, 2021 20:24
@JShep1
Copy link
Author

JShep1 commented Jan 7, 2021

Marking ready for review. I made this guide generalizable to any version of ign-gazebo so it's an easy copy paste. Even though ign-gazebo isn't yet supported, I chose it as the package to build up to in the source build, I thought it would be more straightforward than specifying all of the children dependencies of ign-gazebo

I was wondering if we now want to make an effort to make Windows versions of all the tutorials in all of the separate repos. Such as https://github.com/ignitionrobotics/ign-gui/blob/ign-gui4/tutorials/06_example.md

@JShep1 JShep1 requested review from chapulina and mabelzhang January 7, 2021 20:30
Signed-off-by: John Shepherd <john@openrobotics.org>
@JShep1 JShep1 linked an issue Jan 7, 2021 that may be closed by this pull request
Copy link
Contributor

@chapulina chapulina left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I haven't tried it on Windows, just have some high-level comments.

I was wondering if we now want to make an effort to make Windows versions of all the tutorials in all of the separate repos

That's what @mabelzhang has been doing on #117, right?

citadel/install.md Outdated Show resolved Hide resolved
citadel/install_windows.md Outdated Show resolved Hide resolved
@chapulina chapulina requested a review from j-rivero January 14, 2021 04:08
@mabelzhang
Copy link
Contributor

mabelzhang commented Jan 14, 2021

That's what @mabelzhang has been doing on #117, right?

I think he might be referring to the OS-specific commands in the feature tutorials, not the installation tutorials. Like, are users on their own to figure out what the equivalent commands are on Windows for the different features, or do we want to be responsible for testing all of them and making sure they work on Windows.

@chapulina
Copy link
Contributor

I think he might be referring to the OS-specific commands in the feature tutorials,

Ah yes, got it! This is out of the scope for now, but something that needs to be done in the future.

Copy link
Contributor

@mabelzhang mabelzhang left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I haven't tried the colcon commands yet. Just formatting comments.

Is there a way to preview these locally? I didn't find a CMake file. Is it Doxygen or something else?

citadel/install_windows_src.md Outdated Show resolved Hide resolved
citadel/install_windows_src.md Outdated Show resolved Hide resolved
Copy link
Contributor

@mabelzhang mabelzhang left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I ran the tutorial. Compiling will take a while. Just a few comments on details.

citadel/install_windows.md Outdated Show resolved Hide resolved
citadel/install_windows_src.md Outdated Show resolved Hide resolved
citadel/install_windows_src.md Outdated Show resolved Hide resolved
citadel/install_windows_src.md Outdated Show resolved Hide resolved
citadel/install_windows_src.md Outdated Show resolved Hide resolved
citadel/install_windows_src.md Show resolved Hide resolved
citadel/install_windows_src.md Outdated Show resolved Hide resolved
citadel/install_windows_src.md Outdated Show resolved Hide resolved
John Shepherd added 3 commits January 15, 2021 14:54
Signed-off-by: John Shepherd <john@openrobotics.org>
…/ignitionrobotics/docs into jshep1/top_level_windows_install

Signed-off-by: John Shepherd <john@openrobotics.org>
Signed-off-by: John Shepherd <john@openrobotics.org>
Copy link
Contributor

@mabelzhang mabelzhang left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for addressing the comments! Colcon built for me as described. Looks good. Approving for content. Feel free to adjust formatting as needed.
@chapulina is there a way to preview these locally like we can with the Doxygen docs? The build_docs.sh seems to upload straight to the web.

@chapulina
Copy link
Contributor

is there a way to preview these locally like we can with the Doxygen docs?

No 😢 #85

@mabelzhang
Copy link
Contributor

Perfect description 😅
Alright then I have no more comments. We won't know if that Getting Started link is fixed till it's deployed.

Copy link
Contributor

@chapulina chapulina left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I just have some nitpicks. Let's merge and deploy to see what it looks like!

citadel/install.md Outdated Show resolved Hide resolved
citadel/install.md Outdated Show resolved Hide resolved
citadel/install_windows_src.md Outdated Show resolved Hide resolved
citadel/install_windows_src.md Show resolved Hide resolved
Signed-off-by: John Shepherd <john@openrobotics.org>
@JShep1 JShep1 merged commit 9f3ebb9 into master Jan 21, 2021
@JShep1 JShep1 deleted the jshep1/top_level_windows_install branch January 21, 2021 01:51
@chapulina chapulina mentioned this pull request Mar 10, 2021
2 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
🏰 citadel Ignition Citadel documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Top-level Windows installation instructions
3 participants